go打包时assets目录找不到是因为未用embed嵌入，程序运行时仍按相对路径查找；正确做法是在.go文件中用//go:embed assets/*声明embed.fs变量，路径须相对于该文件所在目录，且大小写严格匹配。
打包时 assets 目录找不到，报 open assets/config.yaml: no such file or directory
Go 默认只编译 .go 文件，assets/ 这类非代码资源不会自动打进二进制里。你本地 go run . 能跑，是因为当前工作目录下真有这个文件；但打包后执行，程序仍会按相对路径去磁盘找——而该路径在目标机器上根本不存在。
常见错误现象：服务启动 panic，堆栈里反复出现 os.Open 或 os.ReadFile 失败，错误信息明确指向某个 config、template、sql 或 image 文件。
- 别把 assets 当成“随代码一起编译”的东西——它只是普通文件，Go 不打包它
- 不要依赖
./assets这种硬编码路径，工作目录（os.Getwd()）在不同环境差异极大 - 用
embed包是唯一原生方案（Go 1.16+），其他方案（如 go-bindata）已过时或维护停滞
正确做法：在 main.go 或入口文件中用 embed.FS 声明并加载：
import "embed"
<p>//go:embed assets/*
var assetFS embed.FS</p><p>func loadConfig() {
data, err := assetFS.ReadFile("assets/config.yaml")
if err != nil {
log.Fatal(err) // 注意：embed 读取失败是运行时错误，不是编译期
}
// ...
}</p>
embed 使用限制与易错点
embed 只支持编译期静态嵌入，路径必须是字面量字符串，不能拼接变量或运行时计算。一旦违反，编译直接报错 cannot embed relative path containing "." 或 invalid pattern。
-
//go:embed assets/**是合法的，但//go:embed assets/*.yaml在某些 Go 版本中不支持通配符层级，建议用assets/*覆盖全部子目录 -
embed.FS返回的是只读文件系统，assetFS.ReadDir("assets")可用于遍历，但无法写入或修改 - 如果 assets 目录下有大量小文件（如图标、模板片段），嵌入后二进制体积会增大，需权衡——没有压缩机制，也不支持按需加载
- 路径区分大小写，
assets/Config.yaml和assets/config.yaml是两个不同路径，ReadFile严格匹配
Docker 构建时 assets 未被 COPY 导致容器内缺失
即使用了 embed，若你在 Dockerfile 中仍试图从宿主机挂载或复制 assets 目录，反而会造成混淆甚至覆盖。更常见的是：没用 embed，却忘了在 Dockerfile 里显式 COPY assets/ /app/assets/。
- 确认构建上下文是否包含
assets/目录（docker build .的.下必须存在该目录） - Dockerfile 中
COPY . .不会自动忽略.git，但可能漏掉隐藏文件（如.env.example），检查.dockerignore - 如果用了多阶段构建，确保
COPY --from=builder /workspace/assets /app/assets这类语句位置正确，且源路径存在 - 容器内验证：运行容器后执行
ls -l /app/assets，别只信日志里“配置加载成功”
线上环境配置路径与本地开发不一致
很多人把 embed 当万能解，结果上线后发现数据库密码要动态注入、证书要挂载 Secret——这些没法编译进二进制。这时必须保留外部文件加载能力，但得让它可靠。
- 优先用环境变量控制路径：
CONFIG_PATH=/etc/myapp/config.yaml，而非死写./config.yaml - 启动时打印实际加载路径：
log.Printf("loading config from %s", configPath)，避免“以为读了，其实读空” - 对非 embed 场景，用
os.Stat(configPath)提前校验文件是否存在、是否可读，比等到ReadFile失败再 panic 更友好 - systemd 服务或 k8s Pod 启动前，务必检查挂载卷权限（
ls -l /mnt/config），常见坑是 root 写、app 用户无读权限
embed 解决的是“发布即带资源”的确定性问题，但真实部署永远绕不开路径、权限、挂载三座大山。最稳的做法不是选一种方案，而是让 embed 和外部路径加载共存，并在启动时做明确的 fallback 判断。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
