装完golangci-lint不等于IDE能标红——GoLand默认不自动读配置、不启用关键检查器，必须手动配置可执行路径、勾选“使用配置”并指定严格匹配的.golangci.yml（与go.mod同级、命名准确）、启用errcheck/staticcheck/unused等linter，且需调低并发、设妥严重性级别。
装完 golangci-lint 不等于 IDE 里就能标红——GoLand 默认不自动读配置、不启用关键检查器，必须手动配路径、开检查项、指定配置文件，否则 govet 和 errcheck 都可能不生效。
GoLand 找不到 golangci-lint 可执行文件
现象：设置里点“下载”失败，或选了路径后仍提示“executable not found”。这不是插件问题，是 GoLand 启动时没读到你的 shell 环境变量。
- 别依赖
go install安装 —— 它会污染 module cache，且 GoLand GUI 启动时根本找不到$(go env GOPATH)/bin - 用官方脚本装：
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2 - 确认
$(go env GOPATH)/bin在$PATH中：macOS zsh 用户检查~/.zshrc是否含export PATH="$GOPATH/bin:$PATH"，改完必须source ~/.zshrc - 在 GoLand 设置里手动填路径：按
Ctrl+Alt+S→Go | 静态分析器→ 点“+” → “浏览”，选$(go env GOPATH)/bin/golangci-lint
.golangci.yml 放哪、怎么写才被 GoLand 识别
GoLand 不会自动扫描项目根目录找配置文件，它只认你显式指定的路径，且要求文件名、位置、内容三者严格匹配。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 文件名必须是
.golangci.yml（不是.golangci.yaml、golangci.yml或带.bak） - 必须和
go.mod在同一级目录 —— 如果go.mod在backend/子目录，配置文件就得放那儿，不能放项目根目录 - GoLand 设置里要勾选“使用配置”，并在输入框填完整路径，例如
backend/.golangci.yml（相对路径无效） - 最小有效配置至少得启用：
errcheck（捕获未处理 error）、staticcheck（查 SA 规则）、unused（死代码），默认只开govet和errcheck
启用了 linter 却没报错？检查并发与严重性设置
常见假象：配置写了 enable: ["staticcheck"]，但编辑器里毫无波浪线。实际是 GoLand 调用时卡在并发或严重性阈值上。
立即学习“go语言免费学习笔记（深入）”；
- GoLand 默认并发数太高，大项目容易内存溢出静默失败 —— 在
Go | 静态分析器里把“并发”调成2或4 - 检查严重性是否设为“警告”或“错误”：点击“配置严重性”，确保
staticcheck和errcheck的级别不低于“警告” - 如果仍不显示，终端进项目目录手动跑：
golangci-lint run --config=backend/.golangci.yml --no-config ./...，对比输出 —— 终端能报但 IDE 不标，就是插件调用链断了 - 多 module 项目（如 monorepo）中，每个 module 目录下都得有独立的
.golangci.yml，父目录配置不继承
最易被忽略的是配置文件路径的精确性 —— GoLand 不做路径推测，./.golangci.yml 和 backend/.golangci.yml 是两个世界，差一个目录就全失效。
