.NET 分析器警告批量修复

技能文档

---
name: melodic-software-fix-warnings
title: .NET 分析器警告批量修复
category: 开发工具
description: 为 .NET 项目批量修复 Roslyn 分析器警告，支持按类别（style/quality/naming/performance/security/nullable/async 等）过滤、按严重级别筛选、预览模式、逐条交互确认与指定项目，修复后自动重新构建验证。当用户需要清理编译警告、批量修复 IDE/CA/CS 分析器告警、整理代码风格时触发。触发词：修复警告、分析器警告、dotnet format、警告清理。
---

# .NET 分析器警告批量修复

按类别过滤、支持预览与交互确认地批量修复 .NET 项目的分析器警告。

## 参数

从用户指令中解析以下参数：

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--category <类别>` | 只修复指定类别（见下表） | 全部可修复项 |
| `--severity <级别>` | 最低严重级别（error, warning, suggestion, hidden） | warning |
| `--preview` | 仅展示将要做的修改，不落盘 | false |
| `--interactive` | 每类修复前逐条确认 | false |
| `--project <名称>` | 只处理指定项目（支持模糊匹配） | 全部项目 |

## 警告类别

| 类别 | 说明 | 分析器前缀 |
|------|------|-------------|
| `style` | 代码风格（IDE*） | IDE0001-IDE0999 |
| `quality` | 代码质量（CA*） | CA1000-CA9999 |
| `naming` | 命名规范 | CA1700-CA1727, IDE1006 |
| `performance` | 性能问题 | CA1800-CA1869 |
| `security` | 安全问题 | CA2100-CA2399, CA3000-CA3147 |
| `reliability` | 可靠性问题 | CA2000-CA2099 |
| `usage` | API 使用问题 | CA2200-CA2249 |
| `nullable` | 可空引用警告 | CS8600-CS8799 |
| `async` | 异步 await 问题 | CA2007, CA2008, CS8892 |

## 技能工作流

### 步骤1：运行分析器

带详细诊断构建：

```bash
dotnet build --no-incremental -warnaserror:0 2>&1
```

或对可自动修复的警告使用 format 检查：

```bash
dotnet format analyzers --verify-no-changes --verbosity diagnostic
```

### 步骤2：解析并归类警告

按以下维度分组：

- 类别（style、quality、naming 等）
- 严重级别（error、warning、suggestion）
- 文件位置
- 可修复性（自动修复 vs 人工处理）

### 步骤3：呈现汇总

```text
分析器警告汇总

  类别          数量    可自动修复
  ─────────────────────────────────────
  Style         42      38
  Quality       15      8
  Naming        7       7
  Nullable      23      12
  Performance   3       1
  ─────────────────────────────────────
  合计          90      66

涉及文件：28

使用 --preview 查看具体警告。
不带参数运行则修复所有可自动修复的警告。
```

### 步骤4：预览模式（--preview）

展示将要做的修改：

```text
预览：待修复警告

IDE0008 (Style): 使用显式类型替代 'var'（12 处）
  - src/MyApp/Services/UserService.cs:42
  - src/MyApp/Services/UserService.cs:56
  - src/MyApp/Controllers/ApiController.cs:23
  …… 以及另外 9 处

CA1062 (Quality): 公共方法需校验参数（5 处）
  - src/MyApp/Services/DataService.cs:18
  - src/MyApp/Handlers/CommandHandler.cs:31
  …… 以及另外 3 处

CS8618 (Nullable): 非可空字段未初始化（8 处）
  - src/MyApp/Models/User.cs:12
  - src/MyApp/Models/Order.cs:8
  …… 以及另外 6 处

合计：28 个文件中的 66 条可自动修复警告

去掉 --preview 参数运行即可应用修复。
```

### 步骤5：应用修复

**自动模式（默认）：**

```bash
# 修复全部 style 警告
dotnet format style

# 修复全部分析器警告
dotnet format analyzers

# 修复空白符
dotnet format whitespace
```

**按类别修复：**

```bash
# 只修复命名类警告
dotnet format analyzers --diagnostics=CA1700,CA1707,CA1708,CA1710,CA1711,CA1712,CA1713,CA1714,CA1715,CA1716,CA1717,CA1720,CA1721,CA1724,CA1725,CA1727,IDE1006
```

**交互模式（--interactive）：**

对每一类警告逐一确认：

```text
修复 IDE0008：使用显式类型替代 'var'？（12 处）

示例：
  修改前：var service = new UserService();
  修改后：UserService service = new UserService();

选项：
  1. 全部修复（12 处）
  2. 跳过此规则
  3. 逐处审查
```

### 步骤6：验证

修复完成后重新构建：

```bash
dotnet build --no-restore
```

报告因修复而引入的任何问题。

## 输出格式

**汇总模式（无参数）：**

```text
正在修复分析器警告……

已应用修复：
  Style (IDE*):      修复 38 条
  Quality (CA*):     修复 8 条
  Naming:            修复 7 条
  Nullable:          修复 12 条

剩余（无法自动修复）：
  CA1062:  5 条 - 公共方法参数校验（需人工审查）
  CA2000:  3 条 - 对象释放（需人工审查）
  CS8604:  11 条 - 可能的空引用（依赖上下文）

修改文件：28
构建：成功

使用 --category 修复指定类别。
剩余警告请人工处理，或在给出理由后抑制。
```

**交互模式：**

```text
交互式修复警告

[1/5] IDE0008：使用显式类型（12 处）
  全部修复？[Y/n/s(跳过)/r(逐处审查)]
  > Y
  已修复 12 处

[2/5] CA1707：移除成员名中的下划线（3 处）
  全部修复？[Y/n/s(跳过)/r(逐处审查)]
  > r

  1. _myField -> MyField（User.cs:15）
     修复？[y/n] > y

  2. Get_Data() -> GetData()（DataService.cs:42）
     修复？[y/n] > n（跳过 —— 这是有意的约定）

  3. API_VERSION -> ApiVersion（Constants.cs:8）
     修复？[y/n] > y

  已修复 3 处中的 2 处

……（逐类继续）

汇总：
  已修复：52 条
  已跳过：14 条（用户选择）

构建：成功
```

## 常见警告修复方式

| 警告 | 可自动修复 | 人工处理方式 |
|---------|----------|---------------|
| IDE0008 | 是 | 将 `var` 改为显式类型 |
| IDE0003 | 是 | 移除 `this.` 限定 |
| IDE0059 | 是 | 移除不必要的赋值 |
| CA1062 | 部分 | 添加空值检查（依赖上下文） |
| CA2000 | 否 | 添加 `using` 或 `.Dispose()` 调用 |
| CS8618 | 部分 | 添加 `= null!` 或 `required` |
| CA1707 | 是 | 移除下划线 |
| CA1716 | 是 | 重命名以避开关键字冲突 |

## 使用示例

```text
修复所有可自动修复的警告
只预览不修复：--preview
只修复风格类警告：--category style
只修复命名问题：--category naming
交互模式逐条确认：--interactive
只处理指定项目：--project MyApp.Api
只处理 error 和 warning（跳过 suggestion）：--severity warning
```

## 无法自动修复的警告

以下警告需要人工审查：

- **CA2000**（对象释放）：对象生命周期依赖上下文
- **CA1062**（空值检查）：可能需要不同的校验策略
- **CA2007**（ConfigureAwait）：类库与应用的取舍
- **CS8604**（空值流）：可能需要设计调整

对这类警告只报告、不改代码。

## 与 .editorconfig 集成

修复过程遵循 `.editorconfig` 配置：

```ini
# 这些规则将在修复时生效
dotnet_style_var_for_built_in_types = false:warning
dotnet_naming_rule.public_members_must_be_capitalized.severity = warning
```

使用说明

# .NET 分析器警告批量修复

为 .NET 项目批量修复 Roslyn 分析器警告（IDE*/CA*/CS*），支持类别过滤、严重级别筛选、预览与交互确认，修复后自动构建验证。

## 使用

```text
帮我清理这个项目的编译警告，只处理 style 和 nullable 两类，先预览。
```

输出先给出分类汇总（数量、可自动修复比例），确认后执行 `dotnet format` 系列命令修复，最后重新构建报告结果与需要人工处理的剩余项。

## 工作原理

1. `dotnet build` / `dotnet format --verify-no-changes` 收集警告并按类别、级别、可修复性分组
2. 可自动修复项用 `dotnet format style/analyzers/whitespace` 批量处理，支持 `--diagnostics` 按类别缩小范围
3. 上下文依赖的警告（CA2000、CA1062、CS8604 等）只报告不改码；修复后 `dotnet build --no-restore` 验证

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。