本文介绍了两种将文件嵌入 Go 二进制文件的方法，以便在发布程序时无需额外提供文件。针对 Go 1.16 及更高版本，推荐使用 go:embed 指令，它提供了一种简洁高效的方式来嵌入单个或多个文件。对于更早的 Go 版本或需要更灵活的嵌入方式，可以使用 go generate 命令配合自定义脚本来实现。通过这些方法，可以轻松地将配置文件、模板或其他资源文件打包到 Go 程序中，方便部署和分发。
在 Go 程序开发中，有时我们需要将一些静态资源文件（例如文本文件、配置文件、模板文件等）嵌入到最终的可执行文件中，这样在部署程序时就不需要额外携带这些文件，方便分发和管理。Go 提供了多种方式来实现这一目标，本文将介绍两种常用的方法：使用 go:embed 指令和使用 go generate 命令。
使用 go:embed 指令 (Go 1.16+)
Go 1.16 引入了 go:embed 指令，提供了一种非常简洁的方式来嵌入文件。该指令允许你将文件或目录的内容直接嵌入到 Go 代码中，并将其作为字符串、字节切片或 embed.FS 类型访问。
示例：嵌入单个文本文件
假设我们有一个名为 hello.txt 的文本文件，内容为 "Hello, world!"。我们可以使用以下代码将其嵌入到 Go 程序中：
package main
import (
"embed"
"fmt"
)
//go:embed hello.txt
var s string
//go:embed hello.txt
var b []byte
//go:embed hello.txt
var f embed.FS
func main() {
fmt.Println("String:", s)
fmt.Println("Byte Slice:", string(b))
data, _ := f.ReadFile("hello.txt")
fmt.Println("embed.FS:", string(data))
}在这个例子中，//go:embed hello.txt 指令告诉 Go 编译器将 hello.txt 的内容嵌入到变量 s（字符串类型）、b（字节切片类型）和 f（embed.FS 类型）中。
运行程序，输出如下：
String: Hello, world! Byte Slice: Hello, world! embed.FS: Hello, world!
注意事项：
- go:embed 指令必须紧跟在变量声明之前，且之间不能有任何其他代码。
- 嵌入的文件路径是相对于包含 go:embed 指令的 Go 源文件而言的。
- embed.FS 类型提供了一种更灵活的方式来访问嵌入的文件，可以像访问文件系统一样访问嵌入的文件。
使用 go generate 命令 (Go 1.4+)
对于 Go 1.16 之前的版本，或者需要更灵活的嵌入方式，可以使用 go generate 命令配合自定义脚本来实现文件嵌入。这种方法允许你编写自定义的脚本来读取文件内容，并将其生成为 Go 代码。
示例：嵌入多个文本文件
假设我们有多个文本文件（例如 a.txt 和 b.txt），我们希望将它们的内容嵌入到 Go 程序中。
1. 创建目录结构：
main.go scripts/includetxt.go a.txt b.txt
2. main.go 文件：
package main
import "fmt"
//go:generate go run scripts/includetxt.go
func main() {
fmt.Println(a)
fmt.Println(b)
}3. scripts/includetxt.go 文件：
package main
import (
"io"
"io/ioutil"
"os"
"strings"
)
// Reads all .txt files in the current folder
// and encodes them as strings literals in textfiles.go
func main() {
fs, _ := ioutil.ReadDir(".")
out, _ := os.Create("textfiles.go")
out.Write([]byte("package main \n\nconst (\n"))
for _, f := range fs {
if strings.HasSuffix(f.Name(), ".txt") {
out.Write([]byte(strings.TrimSuffix(f.Name(), ".txt") + " = `"))
f, _ := os.Open(f.Name())
io.Copy(out, f)
out.Write([]byte("`\n"))
}
}
out.Write([]byte(")\n"))
}4. 运行 go generate 命令：
go generate
这条命令会执行 main.go 文件中 //go:generate 注释指定的命令，即运行 scripts/includetxt.go 脚本。该脚本会读取当前目录下所有 .txt 文件的内容，并将它们生成为 textfiles.go 文件中的字符串常量。
5. textfiles.go 文件 (自动生成):
package main
const (
a = `hello`
b = `world`
)6. 编译并运行程序：
go build -o main ./main
输出如下：
hello world
注意事项：
- go generate 命令会在执行 go build 命令之前运行，所以需要先运行 go generate 命令生成 textfiles.go 文件。
- scripts/includetxt.go 脚本可以根据需要进行自定义，例如可以读取指定目录下的文件，或者对文件内容进行编码转换。
总结
本文介绍了两种将文件嵌入 Go 二进制文件的方法：使用 go:embed 指令和使用 go generate 命令。go:embed 指令更加简洁易用，适用于 Go 1.16 及更高版本。go generate 命令则更加灵活，可以用于更早的 Go 版本或需要更复杂的文件嵌入场景。选择哪种方法取决于你的具体需求和 Go 版本。通过这些方法，你可以轻松地将配置文件、模板或其他资源文件打包到 Go 程序中，方便部署和分发。
