golangci-lint v2 版本的工作流里，代码格式化和静态检查是分开执行的。目前的官方快速开始文档里，用 run 命令跑代码检查，fmt 命令专门做格式化；两个命令各有独立入口，都支持指定要处理的文件或者目录。这个分工直接影响团队本地开发编辑和持续集成流程的安排：输出检查报告和自动改写源码是两个独立任务，迁移旧脚本的时候要分别核对两边的逻辑。
来源：Golangci-lint 官方快速开始文档
这个专用 fmt 命令不是近期临时新增的功能。根据官网变更记录，独立的 fmt 命令和专属格式化配置，是2025年3月24日随 v2.0.0 正式版同步上线的。当前快速开始文档沿用这套功能划分，还在使用v1版本配置的项目，核心变化是工具的执行边界已经调整，不能只替换一下可执行文件就直接运行。官方还自带了 migrate 命令和配套迁移说明，用来处理两个大版本之间的配置差异。
静态检查侧，run 命令默认就会扫描当前目录下的完整包树，相当于隐式携带了 run ./... 参数。官方默认开启的检查器包括 errcheck、govet、ineffassign、staticcheck 和 unused，分别覆盖未处理错误、可疑代码逻辑、无效赋值、未使用声明这类问题。这些检查器产出的问题报告，和空格错误、导入顺序混乱、代码行超长这类排版问题属于完全不同的类别，不能认为格式化跑完了就等于代码通过了全部静态检查。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
来源：Golangci-lint 官方格式化器文档
格式化侧也没有单套统一规则。官方格式化器列表分别介绍了 gci、gofmt、gofumpt、goimports、golines 与 swaggo 这些工具，各自负责导入语句整理、Go标准格式对齐、更严格的排版约束、长行自动折行、注释格式调整这类不同的任务。文档里单独设置了格式化器配置专区，还给出了专门的命令，可以查看所有支持的格式化器清单，以及当前配置里实际启用的列表，团队可以靠这个核对实际运行的工具，不要光看配置文件里有没有出现某个工具的名字，就默认它已经生效。
执行范围有不少明确的限制。快速开始文档里写得很清楚：直接传目录参数不会自动递归子目录，需要递归扫描的时候得在目录后面加 /... 后缀；跑静态检查的时候，不能混合传入单个文件参数和包/目录参数，而且按单个文件维度检查的所有文件，必须属于同一个Go包。即便已经用格式化器处理了部分文件，包级别的静态检查还是有自身的输入要求。对持续集成的维护者来说，这意味着迁移版本的时候要同时核对命令写法、配置项、包扫描范围这三块，不能把格式化执行成功当成所有代码质量门槛都达标的依据。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
