必须在.golangci.yml中正确配置severity区块并声明version: "2"，否则所有问题默认warning；通过level: error设全局阈值，或用severity-rules按id精准控制特定问题为error以阻断ci。
想让golangci-lint把某些问题标为error强制阻断CI，另一些只作warning提示而不影响构建？必须正确配置severity区块，否则所有问题默认按warning处理，关键缺陷可能被忽略。
确认golangci-lint版本与配置schema兼容
运行golangci-lint --version，确认输出含v2.前缀。v1配置在v2中完全失效，【必须在.golangci.yml顶层显式声明version: "2"】，否则severity配置会被静默忽略。
检查当前Go版本是否≥1.23：执行go version，低于该版本会导致如copyloopvar等依赖新语法的linter无法启用，severity设置虽生效但对应规则不触发。
配置全局严重级别阈值
在.golangci.yml中添加severity区块：
severity:
level: error
default-severity: warning
max-same-issues: 5
【level: error表示所有未显式覆盖的linter问题都升为error】，这会强制CI失败——适合严格门禁场景；若只想收紧部分规则，保留default-severity: warning更安全。
max-same-issues: 5防止同一行重复报错刷屏，超出数量后自动折叠。
为特定linter单独设置严重级别
方法一：在linters-settings下嵌套severity
linters-settings:
errcheck:
severity: error
staticcheck:
severity: warning
此方式直接绑定到具体linter，优先级高于全局default-severity。注意：gosec、govet等不支持该字段，需改用方法二。
方法二：在issues区块中按问题ID精确控制
issues:
severity-rules:
- linters:
- gosec
- govet
- staticcheck
- errcheck
- revive
id: SA1019 # 使用已弃用函数
severity: error
- linters:
- govet
id: printf
severity: warning
这是最精准的控制方式，通过linter ID（如SA1019来自staticcheck）锁定问题类型。ID必须准确，拼错则规则不生效。
用nolint注释临时豁免单行
第一步：在代码行末添加//nolint:govet
第二步：若需同时屏蔽多个linter，用逗号分隔：//nolint:govet,staticcheck
第三步：若要升级该行严重级别（例如把warning变error），必须配合severity-rules中的id匹配，//nolint本身不改变级别，只跳过检查。
注意：nolint仅对紧邻上一行生效，不能跨行作用。
验证severity配置是否生效
① 修改配置后，先执行golangci-lint run --out-format=html -o report.html生成HTML报告
② 打开report.html，观察问题条目前的图标颜色：红色代表error，黄色代表warning
③ 故意引入一个已设为error的问题（如未处理errcheck捕获的错误），运行golangci-lint run，确认终端输出含exit status 1且不继续执行后续命令
④ 若CI中仍不阻断，检查CI脚本是否加了--fix或--fast参数——这两个参数会绕过severity校验逻辑。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
