golangci-lint 找不到命令是因为 sublime text 启动时不继承终端 $path，需硬编码绝对路径、验证 path 差异、确保 go.mod 存在且 go111module=on，并将 executable 设为数组格式如 ["/users/you/go/bin/golangci-lint"]。
golangci-lint 找不到命令？路径必须硬编码绝对路径
Sublime Text 启动时不会继承你在终端里配置的 $PATH，所以即使 which golangci-lint 在终端里能输出，Sublime 也大概率找不到它。这不是插件问题，是进程环境隔离导致的。
- macOS/Linux：打开 Sublime 控制台（
Ctrl+`），运行import os; print(os.environ.get('PATH'))，对比终端里echo $PATH的输出——通常缺$GOPATH/bin和$GOROOT/bin - Windows：系统环境变量必须设在「系统变量」里，仅设在「用户变量」中 Sublime GUI 启动时不可见
-
"executable"字段必须是数组格式：["/Users/you/go/bin/golangci-lint"]，写成字符串会静默失败 - 不能用
~/go/bin/golangci-lint，必须展开为完整路径；Windows 支持["C:/Users/you/go/bin/golangci-lint.exe"]或双反斜杠 - 拼写注意：SublimeLinter 插件识别的是
golangcilint（中间是字母i），不是golangci-lint
保存后没反馈？检查 go.mod 和 GO111MODULE
golangci-lint 默认行为是向上遍历目录树找 go.mod，如果项目根目录没有该文件，又没启用模块模式，它可能卡住几十秒甚至超时，最终不报错也不报告。
- 确保项目根目录存在
go.mod文件；没有就进终端执行go mod init example.com/foo - 在 SublimeLinter 的
env配置里显式加"GO111MODULE": "on"，避免依赖 shell 环境变量 - 若用了自定义
GOPATH或GOROOT，建议一并写进env，例如："GOPATH": "/Users/you/go", "GOROOT": "/usr/local/go" - 加
"args": ["--fast"]可跳过耗时检查（如重复 import），适合编辑时快速反馈 - 指定配置文件路径：
"args": ["-c", "/full/path/to/.golangci.yml"]，防止它自己猜错位置
.golangci.yml 不配等于白装
不提供配置文件时，golangci-lint 默认只启用极少数 linter（比如 govet），像未使用变量、空分支、错误忽略等常见问题完全不报——你感觉“没效果”，其实是它根本没开这些检查。
- 最小可用配置至少要启用
errcheck（检查 error 忽略）、unused（未使用变量/函数）、gosimple（简化建议） - 推荐从官方模板起步：
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/.golangci.yml -o .golangci.yml - 确认配置文件放在项目根目录，且文件名是
.golangci.yml（不是golangci.yaml或其他变体） - 改完配置后重启 Sublime 或手动触发一次 lint（比如保存文件），不要只靠“看起来没报错”来判断是否生效
别再用 GoSublime，LSP-Go + gopls 才是正解
GoSublime 依赖已弃用的 gocode，不支持 Go 1.16+ 模块模式，在 2026 年已彻底失效：补全错乱、跳转失败、保存不格式化，甚至拖慢启动。它和现代 golangci-lint 无法协同工作。
- 立即卸载：
Preferences → Package Control → Remove Package → GoSublime - 安装
SublimeLSP和LSP-Go插件，然后终端执行：go install golang.org/x/tools/gopls@latest（不是go get） - 验证：
gopls version输出必须 ≥v0.14.0；Windows 用户确认gopls.exe在系统级 PATH 中 - LSP-Go 启动卡在 “starting…” 超过 60 秒，大概率是项目缺
go.mod或GOPATH路径含中文/空格——这两项必须干净 - golangci-lint 和 gopls 是互补关系：前者做静态检查，后者管语义功能（补全、跳转、诊断），两者都要配对才完整
go.mod 存在但 GO111MODULE=off，或 .golangci.yml 路径写错但控制台无提示，都会导致“看起来装了却没反应”。先验证路径，再确认模块，最后看配置，顺序不能颠。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
