注意
GitHub Code Quality 目前处于 公开预览 阶段，并将于 2026 年 7 月 20 日正式发布。
公开预览 期间，Code Quality 将不会被计费，尽管 Code Quality 扫描会消耗 GitHub Actions 分钟。 从 2026 年 7 月 20 日起，使用费将产生费用。 请参阅“GitHub Code Quality 计费”。
先决条件
- 企业所有者必须已在您的企业中启用 Code Quality。 请参阅“允许在企业中使用 GitHub Code Quality。”。
- GitHub Actions 必须启用，因为 Code Quality 使用操作来运行每个 CodeQL 分析。
- 若要充分利用该功能，存储库应包含支持 CodeQL的质量分析语言之一。 请参阅 支持的语言。
为你的存储库启用 Code Quality
-
在 GitHub 上，导航到存储库的主页面。
-
在仓库名称下，单击 “Settings”****。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。
-
在边栏中的“安全性”下，单击 代码质量 以显示“代码质量”页。
-
单击“ 启用代码质量”。
-
查看“代码质量”页上的信息：
- 语言： 如果要禁用 CodeQL 任何语言的分析，请清除关联的复选框。
- 运行程序类型： 如果要使用不同的 运行程序，请选择“已标记的运行程序 ”并定义 运行器标签。 请参阅“使用 GitHub 托管的运行器”和“将标签与自托管运行程序结合使用”。
-
单击“ 保存更改 ”保存配置 Code Quality。
提示
如果组织配置了专用注册表的缓存，这些注册表将可用于代码质量分析，以用于解析依赖项。 请参阅“授予安全功能访问专用注册表的权限”。
为您的组织启用Code Quality
注意
目标为 GitHub Code Quality 的组织级别存储库位于 公开预览 且可能会发生更改。
在组织级别，你可以通过单个存储库访问设置来控制Code Quality。 这为你提供了细粒度选项：从启用所有存储库，到针对特定列表或动态筛选条件，从而让你能够有计划地试点 Code Quality，并按自己的节奏逐步推广。 所选中的存储库处于启用状态，并且禁用所选内容之外的存储库。
有关可用访问选项以及筛选和强制实施的工作原理，请参阅 关于GitHub代码质量。
-
在 GitHub 上，导航到组织的主页面。
-
在组织名称下，单击 “Settings”****。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”********。
-
在边栏中的“安全性”下，单击 代码质量。
-
在“存储库访问”下，从下拉菜单中选择一个选项。
- 如果选择了 所选存储库...，请选择要启用的存储库。
- 如果选择了 “匹配筛选器...”，请定义筛选器。
-
（可选）若要防止存储库管理员更改这些设置，请启用 强制访问。
-
如果更改在任何存储库上启用或禁用 Code Quality ，将显示“查看启用和计费更改”对话框，其中显示了已启用和禁用的存储库总数以及关联的成本。 查看详细信息，然后单击“ 确认”。
更改会自动保存，并开始立即传播。 在大型组织中，更改可能需要几分钟才能在所有存储库中应用。
后续步骤
- 对于你的存储库： 浏览代码质量检测结果并合并你的第一个修复。 请参阅“GitHub 代码质量快速入门”。
- 添加代码覆盖率： 上传测试覆盖率报告，可在拉取请求中直接查看覆盖率结果。 请参阅“为存储库设置代码覆盖率”。
- 对于组织： 一目了然地了解存储库的代码运行状况。 请参阅“在组织中探索GitHub代码质量结果”。