GOROOT必须手动设为Go安装根目录（如/usr/local/go），否则go命令可能失效；GOPATH在模块项目中虽不参与构建，但go install仍依赖它，默认设为$HOME/go并确保$GOPATH/bin在PATH中。
GOROOT 和 GOPATH 到底要不要手动设
Go 1.16+ 默认启用模块模式，GOROOT 必须指向 Go 安装根目录（如 /usr/local/go），否则 go env -w 会失败或命令找不到；GOPATH 在纯模块项目中已不参与构建，但 go install 仍默认往 $GOPATH/bin 放二进制——所以建议固定设为 $HOME/go，再用 GOBIN=$HOME/.local/bin 分离工具，避免污染源码目录。
常见错误现象：command not found: gopls 或 go: cannot find main module，往往是因为 PATH 没包含 $GOROOT/bin，或终端没加载 shell 配置文件（比如 zsh 用户改了 ~/.zshrc 却忘了 source）。
-
GOROOT绝对不能指向项目目录或$HOME下任意子路径，否则go build可能静默降级到旧版本 - 不要用
export GOPATH=.这类动态路径，VS Code 的集成终端可能无法继承，导致调试时模块解析失败 - 若项目仍依赖
go get安装工具（如mockgen），GOPATH必须可写，且GOBIN要在PATH前置位置
多 Go 版本共存时怎么切、怎么稳
Go 本身不支持多版本共存，GOROOT 是全局单值。硬删重装或覆盖 /usr/local/go 会导致所有项目构建中断，CI 脚本尤其容易崩。
实操只认两种方案：gvm（专为 Go 设计）和 asdf（通用但需插件）。gvm install 1.21.0 后，每个版本独立编译、各自 GOROOT，gvm use 1.21.0 会自动重写 GOROOT 并刷新 PATH；asdf 需配合 .tool-versions 文件，但 VS Code 的终端默认不加载 shell hook，得手动配置 "terminal.integrated.env.linux" 才生效。
立即学习“go语言免费学习笔记（深入）”；
- 别信“软链接切换”：把
/usr/local/go指向不同版本目录，go env GOROOT仍可能缓存旧值，go mod download行为异常 -
go version和go env GOROOT输出必须严格一致，否则gopls会报invalid go version - CI 中禁止用
gvm或asdf，应显式下载二进制包并解压到固定路径，再设置GOROOT环境变量
Makefile 怎么封装多平台编译和模块管理
Makefile 不是炫技，是让 go build、go test、go mod tidy 这些命令在不同机器上行为一致。关键不是写得多，而是变量和目标设计得准。
例如跨平台构建，build-linux 目标里写 GOOS=linux GOARCH=amd64 go build -o bin/app-linux，比记参数可靠；init 目标执行 go mod init $(MODULE_NAME) && go mod tidy，新人克隆后一条 make init 就能跑起来。
-
GOOS和GOARCH必须作为环境变量传给go build，写成go build -ldflags="-s -w" -o bin/app $$(GOOS)是错的——变量不会展开 -
go mod vendor在 CI 中慎用：vendor 目录体积大、diff 冗长，且 Monorepo 下各子模块 vendor 同一依赖的不同 commit，运行时可能出问题 -
make check这类组合目标，建议按fmt → vet → test顺序执行，go fmt失败就中断，避免无效的 vet 和测试
Monorepo 里 replace 和 go.work 怎么配才不出错
replace 不是快捷方式，是模块路径映射，左边必须和 import 语句完全一致，右边必须是相对于当前 go.mod 的路径（或 file:// 绝对路径）。go.work 也不是“全局 go.mod”，它只是把多个独立模块拉进同一个解析上下文——每个子模块仍要有自己的 go.mod，且 module 名不能重复。
典型坑：在根目录 go.mod 里写 replace example.com/lib => ./lib，但 lib/go.mod 里声明的是 module internal/lib，Go 工具链直接忽略替换，构建时报 cannot find module。
-
go.work的use指令只接受目录，不能写use ./cmd/...或通配符；两个use路径不能重叠（如./a和./a/b） - 本地开发时，
go run当前工作目录必须在go.work的某个use目录内，否则退回到单模块模式，replace不生效 - CI 环境禁用相对路径
replace，统一用file:///full/path/to/lib，或通过GOEXPERIMENT=aliases go mod edit -replace动态注入
真正麻烦的从来不是命令怎么敲，而是路径是否对齐、环境变量是否被继承、工具链版本是否被缓存——这些细节在本地跑通一次不等于线上也稳。
