golangci-lint本身不支持--new或--changed参数，需借助git diff生成.go文件列表并按包分组传入；CI中必须显式指定--config=.golangci.yml，否则退回到默认检查集。
golangci-lint run --new 不能直接用
官方没有 --new 或 --changed 这类开箱即用的参数。所谓“只检查变更文件”，本质是靠外部工具生成文件列表，再传给 golangci-lint run 手动执行——它本身不感知 Git 状态。
Git diff 输出必须转成 Go 包路径格式
直接 git diff --name-only HEAD~1 返回的是相对工作区根的路径（如 internal/http/handler.go），但 golangci-lint run 要求：要么是 Go 包导入路径（如 myproj/internal/http），要么是文件系统路径且属于同一包。混用会导致报错 can't load package: ... no Go files in ...。
- 推荐做法：先用
git diff --name-only HEAD~1 | grep '\.go$'筛出 .go 文件，再用go list -f '{{.Dir}}' -e $(dirname file.go)/...推导包路径（较重） - 更轻量方案：直接传文件路径，但需确保所有文件属于同一包；否则拆成多条命令，按包分组调用
golangci-lint run file1.go file2.go - CI 中常见错误：把
git diff结果直接拼成golangci-lint run $(git diff ...)，结果因跨包或含非 .go 文件而静默失败
CI 脚本里必须显式指定配置文件
即使项目根目录有 .golangci.yml，在 CI 中执行变更文件检查时，golangci-lint run 仍会跳过该配置——除非你加 --config=.golangci.yml。漏掉这句，它就回落到默认启用集（仅 govet、errcheck），你看到的“没报错”其实是“根本没跑 staticcheck”。
- 正确写法：
golangci-lint run --config=.golangci.yml $(git diff --name-only HEAD~1 | grep '\.go$') - 安全起见，加
--no-config测试下是否真依赖配置：如果加了还报错，说明配置路径或内容本身有问题 - GitHub Actions 中注意：默认工作目录可能不是 repo 根，需先
cd ${{ github.workspace }}或用working-directory显式指定
IDE 中无法直接复用变更文件检查逻辑
GoLand 和 VS Code 的 golangci-lint 集成只支持全量扫描或当前文件，不提供“仅当前 Git 变更”的 UI 开关。想在编辑器里逼近这个效果，只能：
立即学习“go语言免费学习笔记（深入）”；
- 手动选中待提交的文件 → 右键 → “Run golangci-lint on Selected Files”（GoLand 支持，VS Code 需装插件扩展）
- 禁用自动后台检查（避免干扰），改用终端命令 + alias 快速触发，例如：
alias glc-new='golangci-lint run --config=.golangci.yml $(git diff --name-only --cached | grep "\.go$")' - 别指望 IDE 自动识别
--cached（暂存区）和HEAD~1（上次提交）的区别——这是 Git 层语义，不在 linter 职责内
真正容易被忽略的是：变更文件检查无法替代全量扫描。比如重构时删了一个函数，但没删它的调用点，staticcheck 的 unused 检查器只会对“被删函数所在文件”生效，而调用点若没改动，就不会进检查范围——这类跨文件引用问题，必须靠定期全量运行兜底。
