golangci-lint需手动启用且依赖正确安装与配置：确保已安装并加入PATH，ALE中需显式添加到g:ale_linters，null-ls中需注册内置source或手写适配，且项目根目录必须存在.go.mod和.golangci.yml。
golangci-lint 能直接被 ALE 或 null-ls 自动发现并启用，但默认不运行——你得显式启用它，否则编辑器里根本看不到任何诊断。
确认 golangci-lint 已安装且可执行
Neovim 不会帮你装工具，只调用 golangci-lint 命令。如果终端里运行 golangci-lint --version 报 “command not found”，那所有后续配置都无效。
- 推荐用官方脚本安装（适配 Go Modules）：
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.52.2 - 确保
$(go env GOPATH)/bin在你的$PATH中（Neovim 启动时会继承 shell 的 PATH，但 GUI 启动或某些桌面环境可能不加载 ~/.bashrc） - 在 Neovim 里执行
:!which golangci-lint验证路径是否可达
在 ALE 中启用 golangci-lint 作为 Go 的 linter
ALE 默认对 Go 只启用 gopls（LSP 模式），golangci-lint 属于“仅磁盘运行”类工具，在 supported-tools.md 里标为 !!，需手动加入 g:ale_linters 才生效。
- 在你的 ALE 配置中添加：
let g:ale_linters = {'go': ['golangci-lint']} - 若同时想保留
gopls的实时诊断（如类型推导、跳转），改用组合：let g:ale_linters = {'go': ['gopls', 'golangci-lint']} - 注意：
golangci-lint运行较慢（尤其首次扫描整个 module），建议关掉自动保存时触发：let g:ale_lint_on_save = 1（默认已开），而禁用实时键入检查：let g:ale_lint_on_text_changed = 'never'
在 null-ls 中注册 golangci-lint 诊断源
null-ls 不像 ALE 那样内置 Go 工具列表，必须手动注册 golangci-lint 为 diagnostics source，且要处理它的 JSON 输出格式。
- 确保已安装
null-ls.nvim并启用：require('null-ls').setup({ sources = { require('null-ls').builtins.diagnostics.golangci_lint } }) - 如果提示
golangci_lint未定义，说明你用的是旧版 null-ls（v0.9+ 才内置该 source）；降级方案是手写 source，用vim.fn.getcwd()传参并解析--out-format=json输出 - null-ls 默认不启用
golangci-lint，即使注册了也要确认当前 buffer 是gofiletype，且项目根目录下存在go.mod（否则它可能静默退出）
最容易被忽略的一点：golangci-lint 的配置文件（.golangci.yml）必须放在项目根目录，而不是 ~/.config/ 下；它不会向上查找，也不会读取全局配置。如果你改了规则却没生效，先 cd 到项目根目录运行 golangci-lint run 看是否报错——Neovim 里看到的，只是它命令行输出的镜像。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
