golangci-lint在Windows上能用，但需手动将%GOPATH%\bin加入系统PATH并重启终端；推荐用go install安装，配置.golangci.yml时路径须用正斜杠/且避免绝对路径。
golangci-lint 在 Windows 上能用，但默认路径、环境变量和执行权限容易出问题——不是装不上，而是装对了却跑不起来。
确认 Go 环境和 GOPATH/bin 是否在 PATH 里
Windows 下 golangci-lint 装完找不到命令，90% 是因为 %GOPATH%\bin 没进系统 PATH。Go 安装器虽会加 C:\Go\bin，但不会自动加 GOPATH 下的 bin 目录。
- 打开命令行，运行
go env GOPATH，记下输出路径（比如C:\Users\Alice\go） - 检查该路径下的
bin子目录是否存在，且里面是否有golangci-lint.exe - 手动把
%GOPATH%\bin（如C:\Users\Alice\go\bin）追加到系统 PATH 环境变量中（需重启终端生效） - 验证：
golangci-lint --version应正常输出，否则说明 PATH 没生效
三种安装方式在 Windows 上的实际表现
不同安装方式对 Windows 兼容性差异明显，别只看文档推荐：
-
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest：最可靠，生成golangci-lint.exe放进%GOPATH%\bin，但要求 Go 版本 ≥ 1.21（旧版需加GO111MODULE=on） -
scoop install golangci-lint：快，但 Scoop 默认装到C:\Users\Alice\scoop\shims，这个路径也得进 PATH；偶尔因签名策略被 Windows Defender 拦住，需临时放行 - 官方
install.sh脚本：PowerShell 下需先运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser才能执行，且脚本依赖wget或curl，Win10/11 自带curl可用，但路径要写全（curl.exe）
.golangci.yml 配置要注意 Windows 路径分隔符
Windows 用户常忽略 YAML 中路径写法导致 skip-dirs 或 exclude-rules 失效：
立即学习“go语言免费学习笔记（深入）”；
- 用正斜杠
/，不是反斜杠\—— YAML 规范不认\作路径分隔符，写成vendor\会被解析为转义字符 - 正确写法：
skip-dirs: ["vendor", "testdata", "mocks"]（字符串列表更安全） - 若需匹配 Windows 特定路径（如
C:/Projects/myapp），仍用/，golangci-lint 内部会自动适配 - 避免在
exclude-rules中写绝对路径，CI 和他人本地环境不一致；优先用相对路径或文件名模式
VS Code 集成时常见失败点
VS Code 的 Go 扩展调用 golangci-lint 出错，通常不是工具本身问题，而是上下文路径或权限卡住：
- 确保 VS Code 是以「当前工作区根目录」为 cwd 启动的；如果从桌面快捷方式启动，它可能默认在用户目录，导致
.golangci.yml找不到 - 在设置中显式指定
"go.lintTool": "golangci-lint"，并确认"go.useLanguageServer": true（gopls 和 linter 协同工作） - 首次打开项目时，VS Code 会提示安装工具；如果跳过，手动运行
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest后，按Ctrl+Shift+P→ “Go: Install/Update Tools”，勾选golangci-lint再装一次 - Windows Defender 实时保护有时会拦截
golangci-lint.exe扫描，表现为“command not found”或进程闪退；临时禁用或添加排除项可验证
真正麻烦的不是装不上，而是它静默失败——没报错、没提示、波浪线也不显示，只在你提交前 CI 突然爆红。每次换新机器或重装系统，PATH 和 VS Code 工作区启动方式这两个点，务必手动再验一遍。
