注意
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为组织启用
您可以一次性为组织中的所有存储库启用或禁用 Code Quality。
-
在 GitHub 上,导航到组织的主页面。
-
在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

-
在边栏中的“安全性”下,单击 代码质量。
-
在“启用代码质量”旁边,使用开关为所有存储库启用 Code Quality 。
后续步骤
- 对于你的存储库: 浏览代码质量检测结果并合并你的第一个修复。 请参阅“GitHub 代码质量快速入门”。
- 添加代码覆盖率: 上传测试覆盖率报告,可在拉取请求中直接查看覆盖率结果。 请参阅“为存储库设置代码覆盖率”。
- 对于组织: 一目了然地了解存储库的代码运行状况。 请参阅“在组织中探索GitHub代码质量结果”。