关于SonarQube自定义Roslyn规则SQALE工作量无法自定义的技术咨询

我之前在基于Roslyn的SonarQube分析器开发中遇到过完全一样的问题，官方SQALE的固定/线性评估确实满足不了自定义工作量的需求，给你三个循序渐进的解决方案：

方案一：分析器内动态指定Debt值（最快捷） #

SonarQube的Roslyn SDK支持在报告Issue时直接传递自定义的技术债务数值，完全绕开SQALE的规则配置。具体步骤：

1. 解析[TechDebt]特性参数：在你的分析器代码中，提取特性里的工作量信息（不管是枚举映射的预设值，还是特性直接传入的自定义数值）
2. 转换为SonarQube的Debt格式：SonarQube用分钟作为债务单位，SDK提供了Debt.FromHours()/Debt.FromMinutes()等工具方法
3. 报告Issue时传入Debt：在context.ReportDiagnostic()中指定debt参数

示例代码片段：

// 假设你的TechDebt特性有一个WorkloadHours属性
var techDebtAttr = symbol.GetAttributes()
    .FirstOrDefault(a => a.AttributeClass.Name.Equals("TechDebt", StringComparison.OrdinalIgnoreCase));

if (techDebtAttr != null)
{
    // 提取特性中的工作量（这里以枚举映射为例，也可以直接读取属性值）
    var smellArg = techDebtAttr.ConstructorArguments[0].Value as Smell?;
    int workloadHours = smellArg switch
    {
        Smell.IndecentExposure => 4,
        Smell.LongMethod => 8,
        _ => 2 // 默认值
    };

    // 转换为SonarQube认可的Debt对象
    var customDebt = Debt.FromHours(workloadHours);
    
    // 报告诊断时传入自定义Debt
    context.ReportDiagnostic(Diagnostic.Create(
        rule: YourDiagnosticRule,
        location: symbol.Locations[0],
        messageArgs: "检测到代码异味：Indecent Exposure",
        debt: customDebt
    ));
}

注意：当分析器直接指定Debt值时，SonarQube会忽略该规则在SQALE中的配置，直接使用你传入的数值。

方案二：手动修改Issue债务（适合小团队临时场景） #

如果你的场景不需要自动化批量处理，可以让团队成员在SonarQube UI中手动调整工作量：

• 找到对应的Issue详情页
• 点击右上角的「Edit」按钮
• 在「Technical Debt」字段中输入自定义数值（支持小时/分钟格式，比如4h或240m）

这个方法不需要修改代码，但适合工作量评估主观性强、需要人工确认的场景。

方案三：扩展SQALE模型（适合长期定制化） #

如果需要在SonarQube层面支持自定义评估逻辑，可以通过开发自定义Java插件扩展SQALE模型：

• 创建一个新的Debt Function类型（比如CUSTOM_ATTRIBUTE），让它读取Issue的自定义属性作为工作量
• 在你的Roslyn分析器中，将工作量值作为Issue的自定义属性传递
• 在SonarQube后台配置规则时，选择这个新的Debt Function

这个方案门槛较高（需要Java开发能力），但适合大型团队的长期定制需求。

内容的提问来源于stack exchange，提问作者Flavourous