Go1.16 初体验，怎样使用 //go:embed

2 月 16 日，Go1.16 版本发布了。对于我们普通开发者来说，本次版本发布了一些有趣的特性，这里列举了重要的几点：

• 新增了 embed 包，在编译时通过使用 //go:embed 指令可以进行嵌入文件的访问，即将文件嵌入到二进制包中。
• 增加了对 macOS ARM64 的支持（Apple silicon）。
• 默认开启 Go modules。
• 修复了一些 bug 和改进一些问题，如构建速度提升 25%，内存使用量降低 15%。
• io/util 包被弃用，所有方法被移至 io 和 os 包。

具体详细的发布日志移步：go1.16，本篇文章关注的是如何使用：//go:embed。

embed 功能说明

embed 能帮我们做什么？一句话概括就是将静态资源文件嵌入到编译的二进制文件中。

这样做有什么优势？个人认为比较重要是保证一个应用的完整性。比如：

1. 比如一个 Web 应用，包含了很多 image 和 html，一般情况下我们需要将所有的文件和编译好的二进制文件拷贝到同一机器。如果是分布式应用还会带来更多的拷贝过程。当然如果使用如 docker 容器镜像方式，是会简化拷贝过程，但也会增加一些负担，如：打包过程。
2. 比如一个 App 应用，本身会携带很多如音频、图片小文件。一般情况下在安装过程中我们需要将许许多多的小文件进行拷贝，我们知道磁盘 I/O 瓶颈比较大的，安装时间长会给用户带来不好的体验。
3. 比如一个游戏应用。
4. 比如一个 WebAssembly 应用等等。

当然上面举的例子只是从一些方面来考虑，具体的打包部署方式需要综合考虑多个因素，如当前公司的自动化运维体系。

embed 能帮我们保证一个应用的整体性和完整性，我觉得对于强迫症的开发者来说一定是个福利，哈哈。下面来看看 embed 的使用方法。

embed 基础用法

通过 官方文档 我们知道 embed 嵌入的三种方式：string、bytes 和 FS（File Systems）。

//go:embed 基本用法是：

embed 进阶用法
Go1.16 为了对 embed 的支持也添加了一个新包 io/fs。两者结合起来可以像之前操作普通文件一样。
常规文件操作
如通过 embed 进行常规的文件目录读取，文件递归遍历等：
//go:embed hello.txt
//go:embed hello.txt assets/*
var f embed.FS

...

entries, err := f.ReadDir(".")
if err != nil {
  panic(err)
}
for _, entry := range entries {
  info, err := entry.Info()
  if err != nil {
    panic(err)
  }
  fmt.Println(info.Name(), info.Size(), info.IsDir())
}

Web 文件系统
通过原生 go http 服务，我们将静态资源文件嵌入到二进制中，做静态文件服务器：

其它 web 框架各自可以试试。
模版操作
通过 embed 方式嵌入模版，渲染模版：
├── main.go
└── tmpl
    ├── en.tmpl
    └── zh.tmpl

版本嵌入
通常我们需要将我们的版本打包到二进制文件中，以便确定我们的版本信息。embed 之前我们可以采取通过 -ldflags 的方法将版本动态的赋值到变量。现在，我们可以通过 embed 方式赋值啦。

执行命令：
$ go run .
Version "dev"

$ go run -tags prod .
Version "0.0.1"

Deepzz
Permalink to Go1.16 初体验，怎样使用 //go:embed