Go二进制安装与环境变量配置正确与否，关键在于GOROOT、GOPATH和PATH是否显式设置且路径一致：export GOROOT=/usr/local/go、export GOPATH=$HOME/go、export PATH=$PATH:$GOROOT/bin:$GOPATH/bin（顺序不可错），并用go env验证输出是否完全匹配；Windows需在PowerShell $PROFILE中配置，golangci-lint须装入$GOPATH/bin并确保PATH生效，VS Code需手动配置go.lintTool为golangci-lint。
Go 二进制安装与环境变量配置是否正确？
很多问题其实卡在 go 命令根本跑不起来，或者 go env 显示的 GOPATH、GOROOT 路径不对。Linux/macOS 下最稳妥的方式是手动解压到 /usr/local/go，然后显式写死路径：
-
export GOROOT=/usr/local/go（不要依赖默认值） -
export GOPATH=$HOME/go（避免用/data/go_projects/path这类非常规路径，容易被 IDE 忽略） -
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin（顺序不能错，$GOPATH/bin必须在最后，否则可能覆盖系统命令）
验证时别只跑 go version，一定要执行 go env GOPATH 和 go env GOROOT 看输出是否和你写的完全一致。Windows 用户注意：PowerShell 和 CMD 的环境变量设置互不影响，VS Code 默认走 PowerShell，得在 $PROFILE 里设。
golangci-lint 安装后为什么命令找不到？
常见原因是 $(go env GOPATH)/bin 没进 PATH，或者安装时用了错误的 Go 版本。用以下命令确认：
- 运行
go env GOPATH，得到路径比如/home/user/go - 检查
/home/user/go/bin/golangci-lint是否真实存在 - 如果不存在，说明安装失败；存在但
which golangci-lint返回空，就是PATH没生效
安装推荐用官方脚本（兼容性最好）：
立即学习“go语言免费学习笔记（深入）”；
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.56.0
别用 go install 方式装，它在 Go 1.21+ 后对 binary 安装支持不稳定，容易装到错的 GOBIN 目录下。
VS Code 中 golangci-lint 不生效？
不是插件没装，而是 VS Code 的 Go 扩展默认用的是 gopls 内置的简单检查，不是 golangci-lint。必须手动指定：
- 打开项目根目录下的
.vscode/settings.json - 加这两行：
"go.lintTool": "golangci-lint"和"go.lintFlags": ["--fast"] - 删掉旧的
go.lintFlags配置（比如带-E或--enable的），那些已被弃用
改完重启 VS Code，打开一个 .go 文件，右下角状态栏应显示 “Linting with golangci-lint”。如果还显示 “gopls” 或报错 “command not found”，说明 golangci-lint 二进制不在 PATH 里——这时候要关掉 VS Code，重新开终端执行 source ~/.zshrc，再启动 VS Code。
配置 .golangci.yml 时哪些项最容易出错？
直接运行 golangci-lint init 生成的配置太宽松，实际项目里常踩三个坑：
-
run.skip-dirs里漏写vendor，导致检查耗时暴涨甚至 OOM -
linters-settings.govet.check-shadowing默认关闭，但 shadowing 是高频 bug，建议设为true -
issues.max-same-issues设太小（比如 3），会让同一类警告只报前几条，掩盖大量同类问题
最小可用配置示例（复制到项目根目录即可用）：
run:
timeout: 2m
skip-dirs:
- vendor
- generated
linters:
enable:
- govet
- staticcheck
- errcheck
- unused
linters-settings:
govet:
check-shadowing: true
issues:
max-same-issues: 0别迷信“全开所有 linter”，golint 已归档，maligned 在 Go 1.20+ 里基本失效，强行启用只会报一堆无意义警告。
真正麻烦的不是装工具，是让不同环节（shell、IDE、CI）看到同一个 golangci-lint 二进制和同一份 .golangci.yml。路径错一环，检查就静默失效。
