go install默认将二进制文件放入$GOBIN，未设置GOBIN时才回退至$GOPATH/bin；因此必须显式配置GOBIN并将其加入PATH前端，否则工具如golint将无法被which找到，且IDE或CI中易因环境变量未加载而失效。
GOBIN 和 GOPATH 设置错，go install 就不往你预期位置放二进制文件
Go 工具链默认把 go install 编译出的可执行文件放在 $GOBIN，而不是 $GOPATH/bin。如果没设 GOBIN，它会 fallback 到 $GOPATH/bin —— 但这个 fallback 行为容易让人误以为只要设了 GOPATH 就够了。
实际踩坑场景：装了 golint、gofumpt 等工具后，which golint 找不到，go install 命令看似成功却没出现在 $PATH 里。
- 必须显式设置
GOBIN，例如：export GOBIN=$HOME/go/bin -
$GOBIN必须加入$PATH，且要放在系统路径之前（避免覆盖系统同名命令） -
GOPATH只影响源码存放位置（$GOPATH/src）、包缓存（$GOPATH/pkg），和可执行文件落地无关 - Go 1.16+ 默认启用
GO111MODULE=on，GOPATH对模块依赖已无直接影响，但它仍是本地开发时go get和go install的默认工作区
go env -w 写死环境变量比 shell profile 更可靠
用 export GOPATH=... 放在 ~/.zshrc 或 ~/.bash_profile 里，看似没问题，但某些 IDE（如 VS Code 的 Go 插件）、CI 脚本、或子 shell 启动时可能读不到这些变量，导致 go 命令行为不一致。
go env -w 是 Go 自带的持久化配置机制，它把值写入 $HOME/go/env（文本文件），所有 go 子命令都会优先读取它，不受 shell 环境干扰。
立即学习“go语言免费学习笔记（深入）”；
- 推荐写法：
go env -w GOPATH=$HOME/go、go env -w GOBIN=$HOME/go/bin - 查看当前生效值：
go env GOPATH、go env GOBIN（不是echo $GOPATH） - 如果误写，用
go env -u GOPATH删除，再重设 - 注意：Windows 用户要用
go env -w GOPATH=C:\Users\name\go，路径分隔符用反斜杠，且不能带 trailing slash
第三方工具（如 gopls）依赖 GOPATH 但不依赖 GOBIN
gopls（Go language server）启动时会扫描 $GOPATH/src 下的代码用于索引、跳转、补全。如果你把项目放在 /tmp/myproj 这类非 GOPATH 路径下，它也能工作——但前提是项目是 module-aware（有 go.mod）。一旦项目没 go.mod，又不在 $GOPATH/src 下，gopls 就无法识别包结构，goto definition 失效，import 提示也乱。
- 旧式 GOPATH 模式项目（无
go.mod）必须放在$GOPATH/src/github.com/user/repo结构下 - 新式 module 项目可以放任意路径，但需确保
go mod init已执行，且go list -m能正确返回模块名 -
gopls不读GOBIN，它只关心源码位置和模块根目录；但你手动运行的golint、goimports等命令，必须能从$PATH找到，也就是依赖GOBIN是否在$PATH中
Mac / Linux 下 $PATH 加载顺序决定工具是否可用
即使 GOBIN 设对了，which gopls 还是找不到，大概率是 $PATH 里有多个 gopls 版本，shell 优先用了旧的那个（比如 Homebrew 装的、或者 VS Code 自带的 embedded 版本）。
验证方式：echo $PATH 看 $GOBIN 是否排在靠前位置；再执行 type -a gopls 查所有匹配路径。
- 把
export PATH=$GOBIN:$PATH放在 shell 配置文件最顶部（不要放在中间或末尾） - 避免重复添加：
if [[ ":$PATH:" != *":$GOBIN:"* ]]; then export PATH="$GOBIN:$PATH"; fi - 重启终端或运行
source ~/.zshrc后，务必用go install golang.org/x/tools/gopls@latest重新安装一次，确保最新版落到$GOBIN - VS Code 的 Go 插件默认优先使用
$GOBIN/gopls，但如果插件设置里指定了"go.goplsPath"，那个路径会覆盖环境变量
Go 环境变量不是“设完就一劳永逸”的东西，go env -w 和 $PATH 的协同关系、工具链版本差异、IDE 的隐式覆盖，任何一个环节松动都会让 gofmt 不生效、gopls 卡住、go run 报找不到包——这些都不是语法错误，而是路径和上下文错位。
