根本原因是Nix环境隔离机制默认不将go加入PATH，须在shell.nix中用buildInputs显式声明如pkgs.go_1_22；避免用pkgs.go符号链接以防版本漂移；GOPATH等应通过shellHook设置；go mod需离线预下载并锁定校验；nix develop不执行shellHook，需迁至devShells；Go构建需加-ldflags="-s -w -buildid="消除不确定性。
为什么 nix-shell 启动后 go 找不到或版本不对
根本原因不是 Go 没装，而是 Nix 的环境隔离机制默认不把 go 放进 $PATH，除非你显式声明依赖。即使系统里有 Go，nix-shell 也完全无视它。
实操建议：
- 在
shell.nix或default.nix中，必须用buildInputs引入go（如pkgs.go_1_22），不能只靠with pkgs; ...包含却不用 - 避免写
pkgs.go—— 这是符号链接，指向不确定的“最新稳定版”，CI 或不同机器上可能拉到1.21或1.22，导致构建不一致 - 如果项目要求
GOBIN或GOPATH，别在 shell 中手动 export；改用shellHook设置，例如：shellHook = ''export GOPATH=$PWD/.gopath'';
如何让 go mod download 在 Nix 环境里真正离线且可复现
Go 默认的模块缓存（$GOMODCACHE）是本地路径，每次 nix-shell 启动都是新环境，缓存失效 → 反复下载 → 网络依赖 + 速度慢 + 偶然失败。
实操建议：
- 把
go mod download提前执行，并用nix-prefetch-git或fetchFromGitHub把vendor/或go.sum锁定的每个模块打包进 Nix store - 更轻量的做法：在
shellHook中设置export GOCACHE=$HOME/.cache/go-build，再用nix-shell --pure外挂一个持久化目录（如--run "nix-shell --argstr cacheDir $HOME/.cache"） - 注意
go mod verify会校验 checksum，所以go.sum必须和模块 tarball 严格匹配；若用fetchzip手动拉包，得确认 URL 返回的是原始归档，而非带 HTML 重定向的页面（否则校验失败报错：checksum mismatch for module）
nix develop 和 nix-shell 对 Go 工具链的支持差异
nix develop（Flakes）默认不加载 shellHook，也不自动 source shell.nix；而老式 nix-shell 会。这直接导致你在 flake.nix 里写的 shellHook 在 nix develop 下静默失效。
实操建议：
- Flakes 场景下，把环境变量、路径设置等逻辑从
shellHook迁移到packages字段或自定义devShells.default的shellHook中，并确保该 devShell 被显式调用（nix develop .#default） - 若用
go插件（如gopls）配合编辑器，别指望nix develop自动把gopls加进 PATH；需在devShells.default.packages显式添加pkgs.gopls -
nix develop不支持--pure，如需强隔离，得靠nix shell（Nix 2.14+）替代，或接受它默认继承部分宿主环境变量（比如HOME）
Go 构建产物路径在 Nix 中为何总被误判为“不可重现”
Go 编译时会把当前工作目录、构建时间、GOVERSION 写进二进制的 debug section，Nix 的 reproduce 检查会因这些字段失败，报错类似：output does not match expected hash。
实操建议：
- 强制 Go 构建时去除非确定性信息：
go build -ldflags="-s -w -buildid=" -o ./bin/app ./cmd/app
- 在 Nix 表达式中，用
stdenv.mkDerivation的postInstall清除 debug 符号（strip ./bin/app），但不如编译期关掉彻底 - 若用
buildGoModule（nixpkgs提供），它默认已加-ldflags="-s -w"，但没清buildid；需额外 patch：ldflags = [ "-s" "-w" "-buildid=" ];
最麻烦的点往往不在配置，而在 Go 本身对构建路径的硬编码 —— 它会把 $PWD 写进 runtime.Caller 的文件路径里，测试或 panic 日志里暴露临时构建路径。这点 Nix 挡不住，得靠 Go 代码里用 filepath.Join("...", "main.go") 替代绝对路径拼接。
