必须用 -ldflags 注入版本号，因 embed 仅支持静态文件嵌入，无法处理编译期动态变量；-X 要求变量未初始化且路径精确匹配，需注意跨平台引号与空格处理。
Embed 不能直接嵌入编译期变量，得靠 go:build + -ldflags
Go 的 embed 包只支持嵌入文件（如 embed.FS），它在编译时读取磁盘上的静态内容，无法感知构建时传入的版本字符串。你想注入 Version 这类动态值，本质是「编译期符号替换」，不是文件嵌入——必须用链接器参数。
-
go build -ldflags="-X main.Version=1.2.3"是唯一可靠方式，它把字符串写进二进制的符号表里 -
main.Version必须是未初始化的string全局变量（不能带= "dev"默认值，否则-X失效） - 如果变量在子包里，比如
cmd.Version，就得写成-X cmd.Version=1.2.3，路径必须完全匹配 - CI 中常用
git describe --tags --always生成版本号，注意过滤掉换行符：-ldflags="-X 'main.Version=$(git describe --tags --always | tr -d '\n')'"
为什么不用 embed 存 version.txt？
有人试过把 version.txt 放进项目、用 embed.FS 读取，看似可行，但实际绕不开问题：这个文件的内容还是得人工维护或 CI 生成，且每次改版本都得提交一次文件——破坏了“编译即发布”的原子性。更关键的是，embed 嵌入的是文件内容，不是构建上下文，你没法在 go build 命令里动态指定它该是什么。
- 嵌入
version.txt后，二进制里存的是文件快照，和 git commit、CI 流水线脱节 - 调试时
./myapp -v输出的版本可能比实际 tag 晚一个提交，因为没人记得更新version.txt -
embed.FS.ReadDir或FS.ReadFile有运行时开销，而main.Version是纯内存访问，零成本
-ldflags 的坑：空格、单引号、跨平台路径
Windows 下 cmd.exe 对引号处理诡异，Linux/macOS 的 shell 又对单双引号敏感，-ldflags 容易因空格或特殊字符崩掉，导致 Version 变成空字符串或报错。
- 永远用单引号包裹整个
-ldflags参数：-ldflags='-X main.Version=1.2.3'，避免 shell 展开 - 如果版本含空格或破折号（如
v1.2.3-rc1），必须加引号：-ldflags='-X "main.Version=v1.2.3-rc1"' - Windows PowerShell 里别用
cmd /c，直接用 PowerShell 语法：go build -ldflags="-X `"`main.Version`"=1.2.3`"" - 检查是否生效：构建后执行
strings myapp | grep Version，能看到明文；或运行时打印fmt.Println(main.Version)
想让版本信息可查又不污染 main 包？抽离到 internal/version
把 Version 变量放在 internal/version/version.go 里，既解耦又防外部 import，但 -X 的路径就得同步改，容易漏。
立即学习“go语言免费学习笔记（深入）”；
- 定义为：
package version; var Version = ""（注意没初始化） - 构建命令变成：
go build -ldflags="-X internal/version.Version=1.2.3" - 使用时：
import "yourproject/internal/version"; fmt.Println(version.Version) - CI 脚本里建议把
-ldflags提成变量，避免多处硬编码：LDFLAGS="-X internal/version.Version=$VERSION"
真正难的不是写哪一行代码，而是确保从 git tag 到 CI 环境变量、再到 -ldflags 字符串的每一步都没被 shell 吃掉字符，也没被 IDE 缓存旧二进制误导判断。
