这个问题本质是Go两种构建模式的差异导致的——模块构建模式（不指定源文件时）和直接编译源文件的模式（指定源文件时），两者对-X参数里的包标识符解析逻辑完全不同。

案例1：模块模式下的“匹配失败” #

当你不带源文件运行go build -ldflags "-X main.GitCommit=abc"时，Go是在模块上下文里工作的（前提是当前目录有go.mod，是模块根目录）：

• 此时go build默认构建的是当前模块下的main包，这个包的唯一标识是你的完整模块路径（比如github.com/marcus/your-playground），而不是单纯的main（main只是包名，不是唯一标识）。
• -X参数的规则是[包的导入路径].[变量名]=[值]，你写的main.GitCommit=abc里的main是包名，不是模块模式下的包导入路径，Go找不到对应的变量，自然不会修改它的值，所以运行程序时输出是空字符串。
• 从go tool nm的输出52a900 D main.GitCommit能看出来，变量确实存在，但因为没被-X正确命中，所以保持了默认的空值。

案例2：直接编译文件时的“精准命中” #

当你指定playground.go运行go build -ldflags "-X main.GitCommit=abc" playground.go时，Go切换到了直接编译源文件的模式：

• 这种模式下，Go不会参考模块上下文，而是把你指定的源文件当作一个独立的main包，这个临时包的标识就被默认设为main。
• 这时候你写的-X main.GitCommit=abc正好匹配这个包的标识，Go就能正确把GitCommit的值设为abc，运行程序自然就能看到预期输出。

怎么让案例1正常工作？ #

如果你想在模块模式下正确注入变量，得用完整的模块导入路径来指定包。比如你的模块路径是github.com/marcus/playground，命令应该改成：

go build -ldflags "-X github.com/marcus/playground.GitCommit=abc"

这样Go就能精准定位到模块下main包的GitCommit变量，修改它的值。

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