可以为单个存储库启用,也可以一次性为组织中的每个存储库启用 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设置来控制****。 这为你提供了细粒度选项:从启用所有存储库,到针对特定列表或动态筛选条件,从而让你能够有计划地试点 Code Quality,并按自己的节奏逐步推广。 所选中的存储库处于启用状态,并且禁用所选内容之外的存储库。
有关可用访问选项以及筛选和强制实施的工作原理,请参阅 面向各类组织和企业的代码质量赋能。
-
在 GitHub 上,导航到组织的主页面。
-
在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

-
在边栏中的“安全性”下,单击 代码质量。
-
在“存储库访问”下,从下拉菜单中选择一个选项。
- 如果选择了 所选存储库...,请选择要启用的存储库。
- 如果选择了 “匹配筛选器...”,请定义筛选器。
-
(可选)若要防止存储库管理员更改这些设置,请启用 强制访问。
-
如果更改在任何存储库上启用或禁用 Code Quality ,将显示“查看启用和计费更改”对话框,其中显示了已启用和禁用的存储库总数以及关联的成本。 查看详细信息,然后单击“ 确认”。
更改会自动保存,并开始立即传播。 在大型组织中,更改可能需要几分钟才能在所有存储库中应用。
如果要跨多个团队推出该功能,我们建议在小组上进行试点,并在在任何地方启用之前优化质量阈值。 请参阅“大规模部署GitHub Code Quality”。
后续步骤
- 添加代码覆盖率: 上传测试套件生成的代码覆盖率数据,即可直接在拉取请求中查看覆盖率结果。 请参阅“为存储库设置代码覆盖率”。
- 对于组织: 一目了然地了解存储库的代码运行状况。 请参阅“探索组织中的 GitHub 代码质量结果”。
