MetricsReloaded插件安装失败主因是网络屏蔽或版本不兼容：需从官网下载匹配IDEA版本（如2023.3+用2.2.0+）的.jar包，通过Settings→Plugins→Install plugin from disk手动安装，并确认启用、版本兼容及Ultimate版功能限制。
MetricsReloaded插件怎么装不起来？
多数人卡在安装环节，不是因为插件本身难，而是 IDEA 的插件市场屏蔽或网络策略导致搜索不到。直接从官网下载 MetricsReloaded 的最新 .jar 包（注意核对兼容的 IDEA 版本，2023.3+ 推荐用 2.2.0+），然后通过 Settings → Plugins → Install plugin from disk 手动加载。
常见错误现象：Plugin 'MetricsReloaded' is incompatible with this installation —— 这说明你下的是旧版（比如适配 IDEA 2021.x）却装在了 2024.x 或 2025.x 上。去插件页面看清楚 “Compatible with” 字段，别信文件名里的“latest”。
- Mac 用户注意：如果重启后仍不生效，检查是否勾选了
Enable plugin（安装后默认可能未启用） - Ultimate 版才支持完整功能；Community 版能装上，但部分度量项（如耦合度）会灰掉不可用
- 装完别急着分析——先关掉所有其他代码质量插件（比如 SonarLint、CheckStyle），避免指标冲突干扰视觉标记
圈复杂度数值旁边的颜色为什么没反应？
颜色标记不出现，大概率是度量范围没开或阈值设太高。插件默认只对 public 和 protected 方法计算并标记，private 方法除非显式配置，否则不参与可视化。
进 Settings → Tools → MetricsReloaded，确认以下三项已启用：
-
Enable complexity calculation（必须勾选） -
Show complexity markers in editor gutter（控制左侧行号旁的色块） -
Analyze on editor opening（否则只在手动触发Calculate Metrics时才刷新）
另外，v(G) 阈值默认是 10，如果你的方法复杂度是 9，它显示黄色但你没注意——建议把警告阈值调低到 7，红色阈值设为 11，更早暴露隐患。
为什么 Kotlin 协程方法的圈复杂度虚高？
Kotlin 的 suspend 函数 + withContext + 多个 try-catch 嵌套，会让 MetricsReloaded 把每个挂起点都算作一个逻辑分支，导致 v(G) 比实际控制流高 2–3 点。这不是误报，而是插件对协程语法糖的解析方式决定的。
解决办法不是关掉度量，而是调整语言权重：
- 在
Settings → Tools → MetricsReloaded → Language Specific → Kotlin中，把CoroutineComplexity设为enabled="false" - 或保留开启，但把它的
weight从默认 1.0 降到 0.5，让最终分值更贴近可维护性真实感知 - 对
when表达式，如果只是枚举匹配（非布尔条件判断），可在方法上加@Suppress("ComplexMethod")注解临时豁免
如何让 MetricsReloaded 跳过 Lombok 生成的代码？
Lombok 的 @Data、@Builder 会生成大量 toString()、hashCode() 等方法，它们天然有高圈复杂度（尤其 toString() 对字段逐个判空拼接），但你不该为这些方法重构。
正确做法是在插件配置里加忽略规则：
- 在
MetricsReloaded → Ignored Rules中新增一行：**/lombok/**（忽略整个 lombok 包路径） - 或更精准地写：
*.toString、*.hashCode、*.equals（支持通配符匹配方法签名） - 如果项目用了
@SuperBuilder，其生成的嵌套 builder 类也容易超标，建议加**Builder到忽略列表
注意：忽略规则只影响度量结果和标记，不影响代码编译或运行——别把它当成掩盖问题的捷径，而是把注意力留给真正需要人工 review 的业务逻辑方法。
