golangci-lint不能原生只检查新增/修改代码，需结合git diff提取变更文件并按包路径组织后调用run命令，且v2.x已移除--new-from-rev等增量参数。
golangci-lint 能不能只检查新增/修改的代码？
不能原生支持「只报新增问题」——它没有 git diff 感知能力，也不会自动对比 PR 前后变更。所谓“增量检查”，本质是人工构造输入范围：把 git diff 输出的文件列表喂给 golangci-lint run，并确保这些文件属于同一包、路径合法、且未被 skip-dirs 过滤。
如何用 git diff + golangci-lint 实现增量检查？
核心是把变更文件转成 golangci-lint run 可接受的参数。注意：不能直接传单个文件列表（如 golangci-lint run a.go b.go），因为 linter 依赖包级上下文；必须按包组织，或统一指定为当前模块根目录。
- 推荐做法：先提取修改的 Go 文件，再用
go list -f '{{.Dir}}' -e获取它们所属的包路径去重，最后对每个唯一包路径执行golangci-lint run - 简单替代（适合单 module 项目）：
git diff --name-only HEAD~1 | grep '\.go$' | xargs dirname | sort -u | xargs -I{} golangci-lint run {} - CI 中务必加
--config=.golangci.yml，否则默认配置可能不启用staticcheck等关键检查器 - 如果某次提交只改了
testdata/或vendor/下的文件，上面命令会输出空，golangci-lint就不会运行——这是预期行为，不是 bug
为什么 --new-from-rev 不起作用？
golangci-lint v2.x 已移除 --new-from-rev 和 --new 参数。官方明确说明：该功能因实现不可靠、与多 module 项目冲突、且易被误用（比如忽略跨文件逻辑缺陷），已在 2025 年 3 月 v2.0.0 发布时彻底删除。你现在看到的文档若还提这个参数，大概率是过时的 v1 教程。
- 试图运行
golangci-lint run --new-from-rev=HEAD~1会报错：flag provided but not defined: -new-from-rev - 不要尝试用
golangci-lint run --fix来“模拟”增量——它会无差别改写所有匹配规则的文件，包括你没动过的 - 真正的增量语义只能由外部工具（如 CI 脚本、pre-commit hook）控制输入范围，
golangci-lint本身只做“给什么就查什么”
PR 场景下最容易漏掉的三个点
即使脚本写对了，CI 里仍常因环境细节失效。这些问题不会报错，但会让“只查新增”变成“查全量”或“查不到”：
-
go.mod不在 git diff 结果的父目录里：比如变更文件是api/handler/user.go，但go.mod在./，而脚本错误地 cd 进api/再跑golangci-lint run ./，会导致配置文件未加载 - CI 使用的 Go 版本太低（如 1.15），无法解析泛型语法，
go list失败，进而使包路径提取为空——结果就是静默跳过检查 - Git 拉取深度不足（
git clone --depth=1），导致HEAD~1不存在，git diff无输出，整个 lint 步骤被跳过
最稳妥的做法，是在 CI 中固定拉取至少两层提交，并始终在 go.mod 所在目录执行所有命令，别依赖相对路径推断。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
