go: embed
go:embed 是 Go 语言在其 1.16 版本中引入的一个新功能，它允许开发者在编译时将文件或文件夹嵌入到 Go 程序中。这样做可以简化资源文件的分发，因为它们会被编译到可执行文件里，避免了在运行时需要处理文件路径和分发额外文件的问题。
要使用 go:embed，你需要做以下几步：
- 导入
embed包。 - 使用
//go:embed指令来标记要嵌入的文件或文件夹。 - 声明一个变量来接收嵌入的内容，类型可以是
string、[]byte或embed.FS（用于目录或多个文件）。
下面是一个使用 go:embed 的示例：
package main
import (
"embed"
"io/fs"
"io/ioutil"
"log"
"net/http"
)
//go:embed version.txt
var version string
//go:embed config.json
var config []byte
//go:embed static
var staticFiles embed.FS
func main() {
// 使用嵌入的字符串
log.Println("Version:", version)
// 使用嵌入的字节切片
configContents, err := ioutil.ReadAll(fs.FS(config))
if err != nil {
log.Fatal(err)
}
log.Println("Config:", string(configContents))
// 使用嵌入的文件系统
http.Handle("/", http.FileServer(http.FS(staticFiles)))
log.Fatal(http.ListenAndServe(":8080", nil))
}
在上面的代码中：
-
version.txt文件的内容会被嵌入到version变量中，类型为string。 -
config.json文件的内容会被嵌入到config变量中，类型为[]byte。 -
static目录及其内容会被嵌入到staticFiles变量中，类型为embed.FS。
请注意，使用 go:embed 的文件或目录必须在同一个包中。此外，go:embed 只能用于全局变量，且这些变量不能是导出的（即变量名不能以大写字母开头），除非它们是用来嵌入的类型（string、[]byte、embed.FS）。
在运行 go build 编译程序时，Go 编译器会处理这些指令，并将指定的文件或目录内容嵌入到最终的可执行文件中。
