Go 的 go install 默认仅编译源码，不复制 config.txt 等非 .go 文件。本文介绍主流方案：使用 go:embed（推荐，Go 1.16+ 原生支持）、bindata（兼容旧版本）或构建脚本辅助分发，兼顾简洁性与可维护性。
go 的 `go install` 默认仅编译源码，不复制 config.txt 等非 `.go` 文件。本文介绍主流方案：使用 `go:embed`（推荐，go 1.16+ 原生支持）、`bindata`（兼容旧版本）或构建脚本辅助分发，兼顾简洁性与可维护性。
在 Go 项目中，go install 仅处理 .go 源文件，不会自动携带 config.txt 等静态资源——这是设计使然，而非疏漏。要让配置文件“随二进制同行”，有三种成熟路径，按推荐度排序如下：
✅ 方案一：使用 embed（Go 1.16+，首选）
Go 原生 embed 包可将文件内容编译进二进制，零依赖、类型安全、无需额外工具。
步骤示例：
- 将 config.txt 放在 src/mypkg/ 下（与 source.go 同级）；
- 在 source.go 中嵌入文件：
package main
import (
"embed"
"fmt"
"io/ioutil"
)
//go:embed config.txt
var configFS embed.FS
func main() {
data, err := ioutil.ReadFile("config.txt") // 注意：此处路径是 embed.FS 中的逻辑路径
if err != nil {
panic(err)
}
fmt.Printf("Config content: %s", string(data))
}⚠️ 注意：embed.FS 中的路径是相对于 //go:embed 注释所在 .go 文件的路径；若 config.txt 在子目录（如 assets/config.txt），需写 //go:embed assets/config.txt 并调整 ReadFile 调用。
构建后，config.txt 已完全内联至二进制，无需外部文件，部署极简。
⚙️ 方案二：使用 go-bindata（Go < 1.16 或需生成字节码场景）
适用于旧版 Go 或需运行时动态解压资源的场景（如大型图片集）：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
# 安装（需 Go < 1.16 时更常用） go get -u github.com/go-bindata/go-bindata/... # 生成绑定文件（在 mypkg 目录下执行） go-bindata -o bindata.go config.txt
生成的 bindata.go 将 config.txt 转为 []byte 变量，代码中通过 Asset("config.txt") 读取。但该工具已归档，新项目优先选 embed。
? 方案三：构建后手动复制（简单分发，非嵌入）
若必须保留外部 config.txt（如需用户编辑），可在 go install 后用脚本补全：
#!/bin/bash go install mypkg cp src/mypkg/config.txt $(go env GOPATH)/bin/
或使用 Makefile 统一管理：
install:
go install mypkg
cp src/mypkg/config.txt $(shell go env GOPATH)/bin/✅ 最佳实践建议：
- 新项目一律优先使用 embed，它语义清晰、无第三方依赖、且被 Go 官方长期维护；
- 避免硬编码文件路径读取外部资源，否则跨平台或容器部署易失败；
- 若配置需热更新，应改用环境变量或远程配置中心，而非依赖本地文件。
最终，go install 本身不负责资源分发——这是构建策略问题。选择 embed，即可用一行注释实现“配置即代码”，真正达成单二进制交付。
