编辑“︁C Sharp 代码质量度量”︁（章节）

= C#代码质量度量 =

== 介绍 ==
'''代码质量度量'''是评估C#程序健壮性、可维护性和效率的系统化方法。通过量化指标（如圈复杂度、代码重复率、单元测试覆盖率等），开发者能够识别潜在问题并优化代码结构。高质量的代码通常表现为：
* 低耦合高内聚
* 可读性强
* 易于扩展和维护
* 符合行业规范（如Microsoft的C#编码准则）

== 核心度量指标 ==
=== 1. 圈复杂度（Cyclomatic Complexity） ===
衡量代码路径复杂度的指标，计算公式为：
<math>M = E - N + 2P</math>
其中：
* <math>E</math> = 控制流图的边数
* <math>N</math> = 节点数
* <math>P</math> = 连通分量数

'''示例：'''
<syntaxhighlight lang="csharp">
// 高复杂度方法（圈复杂度=4）
public string EvaluateGrade(int score) {
    if (score >= 90) return "A";
    else if (score >= 80) return "B";
    else if (score >= 70) return "C";
    else return "F";
}

// 优化后（圈复杂度=1）
public string EvaluateGrade(int score) => score switch {
    >= 90 => "A",
    >= 80 => "B",
    >= 70 => "C",
    _ => "F"
};
</syntaxhighlight>

=== 2. 代码重复率 ===
检测重复代码块的工具（如SonarQube）可识别以下情况：
<syntaxhighlight lang="csharp">
// 重复模式示例
class A {
    public void Process() {
        Console.WriteLine("Step 1");
        Console.WriteLine("Step 2");
    }
}

class B {
    public void Execute() {
        Console.WriteLine("Step 1");  // 重复代码
        Console.WriteLine("Step 2");  // 重复代码
    }
}
</syntaxhighlight>

=== 3. 单元测试覆盖率 ===
通过工具（如Coverlet）统计被测试代码的比例：

<mermaid>
pie
    title 测试覆盖率示例
    "已覆盖" : 75
    "未覆盖" : 25
</mermaid>

== 静态代码分析工具 ==
{| class="wikitable"
|+ 常用工具对比
! 工具名称 !! 检测能力 !! 集成方式
|-
| Roslyn Analyzers || 实时语法检查 || VS内置
|-
| SonarQube || 全项目扫描 || CI/CD管道
|-
| NDepend || 架构级分析 || 独立应用
|}

== 实际案例 ==
'''电商系统库存管理优化'''
* 原始代码：圈复杂度12，重复率18%
* 问题：嵌套条件逻辑导致维护困难
* 优化方案：
  * 用策略模式替换条件分支
  * 提取公共方法消除重复
* 结果：复杂度降至4，重复率2%

<syntaxhighlight lang="csharp">
// 优化前
public void UpdateInventory(Product p, int change) {
    if (p != null) {
        if (change > 0) {
            if (p.Stock + change <= p.MaxStock) {
                p.Stock += change;
            }
        }
        // 更多嵌套条件...
    }
}

// 优化后
public void UpdateInventory(Product p, int change) 
    => new InventoryUpdater(p).ApplyChange(change);
</syntaxhighlight>

== 最佳实践建议 ==
# 保持方法圈复杂度<10
# 代码重复率控制在<5%
# 单元测试覆盖率≥80%
# 使用<code>#region</code>组织复杂类
# 遵循SOLID原则

== 进阶技巧 ==
* '''自定义Roslyn诊断器'''：创建特定项目的代码规则
* '''历史趋势分析'''：通过CI工具跟踪质量变化
* '''架构可视化'''：用DGML生成依赖关系图

<mermaid>
graph TD
    A[原始代码] --> B(静态分析)
    B --> C{是否达标?}
    C -->|是| D[提交]
    C -->|否| E[本地修复]
</mermaid>

== 参见 ==
* [[w:Code quality|维基百科代码质量]]
* Microsoft C#编码规范

[[Category:编程语言]]
[[Category:C Sharp]]
[[Category:C Sharp 最佳实践]]