使用ldflags向二进制文件嵌入构建信息遇阻，求原因解析

核心原因：错误指定了main包的导入路径 #

Go链接器的-X参数格式为package.variable=value，其中的package指的是包的导入路径，而非代码里声明的包名。你之前的错误在于，把main包的导入路径写成了repo/cmd/project1/main，但实际上：

• cmd/project1目录下的main.go声明的包名是main，这个包的完整导入路径是repo/cmd/project1（模块路径repo加上目录路径cmd/project1），main是包名，不是导入路径的一部分。
• 链接器找不到repo/cmd/project1/main这个包，自然无法给对应变量赋值，所以读取时为空。

而你后来创建的version包，其导入路径确实是repo/cmd/project1/version（模块路径+目录路径），所以-X参数能正确定位到包内变量，因此生效。

正确的构建命令示例 #

无需额外创建version包，只需要修正-X参数里的包路径即可：

方式1：使用完整导入路径 #

go build -ldflags="-X 'repo/cmd/project1.BuildTime=2023-10-24 14:22' \
-X 'repo/cmd/project1.GitCommit=648c53d' \
-X 'repo/cmd/project1.GoVersion=go1.21.0' \
-X 'repo/cmd/project1.OsArch=arm64' \
-X 'repo/cmd/project1.OsName=darwin' \
-X 'repo/cmd/project1.VersionMetadata=' \
-X 'repo/cmd/project1.FullVersion=v0.0.0'" \
./cmd/project1 

方式2：简化为main.Variable（因为构建目标是该main包） #

和根目录下的main包一样，当直接构建./cmd/project1时，可以省略完整导入路径，直接用包名main：

go build -ldflags="-X 'main.BuildTime=2023-10-24 14:22' \
-X 'main.GitCommit=648c53d' \
-X 'main.GoVersion=go1.21.0' \
-X 'main.OsArch=arm64' \
-X 'main.OsName=darwin' \
-X 'main.VersionMetadata=' \
-X 'main.FullVersion=v0.0.0'" \
./cmd/project1 

补充说明 #

• 当main包在仓库根目录时，其导入路径是repo，此时用main.Variable或repo.Variable都能生效，因为链接器会自动关联当前构建的main包。
• 链接器的-X参数仅对未初始化的全局变量生效，确保你的main包内的变量是声明但未赋值的（比如var BuildTime string，而非var BuildTime = "default"）。

内容的提问来源于stack exchange，提问作者Hiago Prata