golangci-lint v2.0.0起内置migrate命令用于配置升级，可生成新版兼容草案但不自动覆盖；exhaustive检查器字段需人工重写，如explicit-exhaustive-switch→explicit-exhaustive、ignore-enum-members→ignore-constants切片，并验证实际生效及CI参数同步。
用 migrate 命令批量替换弃用字段
golangci-lint 自 v2.0.0 起内置了 migrate 命令，专用于处理配置项升级。它不会自动修改你的 .golangci.yml，但能生成兼容新版（如 2.15.0）的等效配置草案。运行前确保当前目录下有原始配置文件：
golangci-lint migrate .golangci.yml
该命令会输出迁移后的 YAML 内容到 stdout，不覆盖原文件。你需要手动复制粘贴并校验——尤其注意 exhaustive 相关字段是否已从 explicit-exhaustive-switch 改为 explicit-exhaustive，ignore-enum-members 是否已转为 ignore-constants 切片形式。
exhaustive 检查器字段必须手动重写
2.15.0 中 exhaustive 的配置结构发生实质性变化，migrate 只能做基础字段映射，无法推断语义。以下常见旧写法必须人工修正：
-
explicit-exhaustive-switch: true→ 改为explicit-exhaustive: true，且需确认是否同时启用switch、mapliteral或typeswitch子项 -
ignore-enum-members: ["Unknown"]→ 改为ignore-constants: ["Unknown"]，注意类型从字符串变为字符串切片 -
check: { map: true }→ 改为check: { mapliteral: true }，字段名已变更
直接保留旧字段名会导致配置被忽略，但工具不会报错，容易误以为检查仍在生效。
立即学习“go语言免费学习笔记（深入）”；
验证配置是否真正生效
迁移后不能只看配置文件“长得像新版本”，必须验证实际行为：
- 运行
golangci-lint run -v，观察日志中exhaustive加载时打印的参数是否包含你刚配置的ignore-constants或explicit-exhaustive - 故意在 switch 中漏掉一个枚举分支，确认是否触发告警；再把该分支名加进
ignore-constants，确认告警消失 - 检查
golangci-lint run --help输出的 linters 列表里，exhaustive是否显示为slow类别——这是 2.15.0 新增的性能分类标记，未出现说明配置未加载成功
CI 流水线里要同步更新命令参数
2.15.0 将 exhaustive 归入 slow 分组后，如果 CI 脚本里用了 --fast 标志或按类别筛选 linter，exhaustive 会被跳过。原来能报出的分支遗漏问题，升级后可能完全不检查。
检查你的 CI 配置中是否包含类似逻辑：
-
golangci-lint run --fast→ 必须移除--fast，或显式加上--enable=exhaustive -
golangci-lint run --disable-all --enable=errcheck,govet→ 确保列表里包含exhaustive - GitHub Actions 中使用
github-actionsformat 时，注意报告文案已更新，若下游有正则解析提示文本的脚本，需同步调整匹配模式
配置字段改对了，但执行范围被命令参数意外排除，是最隐蔽也最容易被忽略的问题。
