Go语言环境搭建与编译机制初步接触-Golang-PHP中文网

go环境能跑不等于懂编译机制：gobin控制go install输出路径（优先于gopath/bin），go build不读gobin；go run与go build对main包、依赖解析和模块模式处理逻辑不同，go111module=on需显式确认，项目不应放在$gopath/src下。

go语言环境搭建与编译机制初步接触

Go 环境能跑起来，不等于编译机制你真懂了——很多“go run 能跑，go build 失败”或“本地能编译，CI 上报错”的问题，都卡在 GOPATH、GOBIN、模块模式切换和 go install 与 go build 的语义差异上。

GOBIN 和 GOPATH/bin 不是同一个东西，但很多人混着用

GOBIN 是 Go 1.16+ 显式控制二进制输出路径的环境变量；而 GOPATH/bin 是旧模块时代（GO111MODULE=off）下 go install 默认写入的位置。两者冲突时，go install 优先走 GOBIN，但 go build -o xxx 完全不看它。

如果你设了 GOBIN=/usr/local/bin，又没加进 $PATH，那 go install 成功后命令却找不到
用 go install 安装第三方工具（如 protoc-gen-go）时，必须确保 GOBIN 在 $PATH 中，否则 shell 找不到可执行文件
go env GOPATH 查到的是 GOPATH 路径，但 go env GOBIN 可能为空——这时它默认 fallback 到 $GOPATH/bin，容易误判

go run 和 go build 对 main 包的处理逻辑完全不同

go run 是临时编译并执行，不生成持久文件；go build 是生成可执行文件，且会严格检查依赖是否可解析、是否满足构建约束（build tags）、是否有未使用的导入（-ldflags="-s -w" 会影响符号表但不解决 import 错误）。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

go run main.go 可以绕过某些 vendor 或 replace 规则，而 go build 会严格执行 go.mod 中定义的版本约束
如果 main.go 里 import 了一个本地路径包（如 "./util"），但该目录下没有 go.mod 或 go.sum，go run 可能侥幸成功，go build 却报 no required module provides package
go run . 和 go run main.go 行为也不同：前者会自动发现当前目录下所有 *.go 文件并合并编译，后者只编译显式列出的文件，容易漏掉 init 函数或嵌入的资源

go mod init 后，go build 默认进入 module-aware 模式，但 GOPATH 仍可能干扰

即使你已经 go mod init example.com/foo，只要环境里还残留 GO111MODULE=off 或项目在 $GOPATH/src 下，Go 工具链仍可能退回到 GOPATH 模式，导致依赖解析失败或拉取错误版本。

执行 go env GO111MODULE，确认返回 on；若为 auto，在非 GOPATH 下才启用模块，风险高
不要把新项目放在 $GOPATH/src 里——哪怕有 go.mod，Go 有时仍会尝试从 GOPATH 加载依赖
go list -m all 能看到当前实际解析的模块版本，比 go.mod 更真实；如果里面出现 sum: none，说明某依赖未经过校验，可能是 GOPATH 干扰所致