# 修复代码库待办事项中的代码质量问题

为存储库默认分支上的调查结果生成自动修复，或忽略不相关的调查结果。

> \[!TIP]
> 如果你不熟悉 Code Quality，请参阅 [提高存储库的代码质量分数](/zh/enterprise-cloud@latest/code-security/tutorials/improve-code-quality/raise-your-quality-rating?utm_campaign=code-quality-ga-july-2026\&utm_medium=docs\&utm_source=docs-fix-backlog-walkthrough-tip)，观看关于查看和提高存储库质量分数的引导式演练。

## Code Quality 如何在您的默认分支上运行

Code Quality 会扫描您的默认分支，并在您的仓库的 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-shield" aria-label="shield" role="img"><path d="M7.467.133a1.748 1.748 0 0 1 1.066 0l5.25 1.68A1.75 1.75 0 0 1 15 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.697 1.697 0 0 1-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 0 1 1.217-1.667Zm.61 1.429a.25.25 0 0 0-.153 0l-5.25 1.68a.25.25 0 0 0-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.196.196 0 0 0 .154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.251.251 0 0 0-.174-.237l-5.25-1.68ZM8.75 4.75v3a.75.75 0 0 1-1.5 0v-3a.75.75 0 0 1 1.5 0ZM9 10.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Security and quality 选项卡中的“\*\*\*\*”页面上报告发现结果。 它运行 **两种类型的分析**。

1. \*\*
   常规发现
   \*\*：Code Quality 使用 CodeQL 对默认分支执行确定性的、基于规则的扫描。 结果按规则和语言分组，并按严重程度（**错误**、**警告**、**提示**）进行标记，每条结果都包含一个建议的自动修复方案。

2. \*\*
   AI 发现
   \*\*： Code Quality 使用 AI 驱动的分析来识别最近推送到默认分支的文件中的质量问题，包括基于规则的分析可能无法检测到的问题，例如最佳做法、命名约定或设计注意事项。

> \[!NOTE]
> 最近更改文件的“AI 发现”页当前处于 公开预览 状态，可能会更改。

有关解析 AI 发现的信息，请参阅 [修复最近合并文件中的代码质量发现](/zh/enterprise-cloud@latest/code-security/how-tos/maintain-quality-code/fix-findings-in-recent-merges)。

## 解决标准调查结果问题

1. 请导航到您的存储库中的\*\*<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-shield" aria-label="shield" role="img"><path d="M7.467.133a1.748 1.748 0 0 1 1.066 0l5.25 1.68A1.75 1.75 0 0 1 15 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.697 1.697 0 0 1-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 0 1 1.217-1.667Zm.61 1.429a.25.25 0 0 0-.153 0l-5.25 1.68a.25.25 0 0 0-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.196.196 0 0 0 .154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.251.251 0 0 0-.174-.237l-5.25-1.68ZM8.75 4.75v3a.75.75 0 0 1-1.5 0v-3a.75.75 0 0 1 1.5 0ZM9 10.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Security and quality\*\* 选项卡。

2. 单击以展开 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-code-review" aria-label="code review" role="img"><path d="M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v8.5A1.75 1.75 0 0 1 14.25 13H8.061l-2.574 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25v-8.5C0 1.784.784 1 1.75 1ZM1.5 2.75v8.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-8.5a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Zm5.28 1.72a.75.75 0 0 1 0 1.06L5.31 7l1.47 1.47a.751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018l-2-2a.75.75 0 0 1 0-1.06l2-2a.75.75 0 0 1 1.06 0Zm2.44 0a.75.75 0 0 1 1.06 0l2 2a.75.75 0 0 1 0 1.06l-2 2a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L10.69 7 9.22 5.53a.75.75 0 0 1 0-1.06Z"></path></svg> 代码质量**，然后单击 **常规发现**。

3. 使用仪表板筛选器专注于最有可能影响质量分数的调查结果。 例如，若要查看“可靠性”的所有“错误”级别结果，请将筛选器设置为：

   `is:open category:reliability severity:error`

4. 结果按规则分组。 单击规则名称以查看该规则的所有结果的详细视图。

   ![“标准发现”视图中某条规则的屏幕截图。 规则名称以深橙色突出显示。](/assets/images/help/code-quality/click-rule-name.png)

5. 单击“ **显示更多**”，然后查看规则的说明、建议的修补程序、支持代码示例和引用。

![显示代码质量规则结果的屏幕截图。 文本“显示更多”以深橙色突出显示。](/assets/images/help/code-quality/click-show-more.png)

1. 在单个发现项的右侧，单击**生成修复方案**。
2. 查看建议的更改的差异。 如果同意该请求，请单击“ **打开拉取请求**”。
3. 在“将自动修复提交到分支”对话框中，选择“打开拉取请求”，然后单击“提交更改”\*\*\*\*。
4. 当自动修复拉取请求可供审查时，请将其状态从“草稿”更改为“可供审查”，并等待 CI 检查通过后再进行合并。
5. 或者，如果发现不相关或可操作，请单击“ **消除**”。 例如，你可能会忽略某项发现：它出现在已不再维护的遗留代码中，属于团队编码标准中的已知例外情况，或者只是不会带来实际质量风险的误报。

若要提高可维护性或可靠性分数，必须解决当前影响该指标的最高严重级别的每个发现。 请参阅“[指标和评分参考](/zh/enterprise-cloud@latest/code-security/reference/code-quality/metrics-and-ratings)”。

## 验证代码质量分数是否已更新

在合并了您的自动修复拉取请求后，请返回到“常规发现”视图以确认：

* 发现次数已减少。
* 如果解决了该指标的当前最低严重性级别的所有发现，可维护性或可靠性分数已得到改善。

## 后续步骤

* [修复最近合并文件中的代码质量发现](/zh/enterprise-cloud@latest/code-security/how-tos/maintain-quality-code/fix-findings-in-recent-merges)