{"meta":{"title":"配置代码扫描的默认设置","intro":"快速设置 code scanning 以自动查找 和修复 易受攻击的代码。","product":"安全性和代码质量","breadcrumbs":[{"href":"/zh/code-security","title":"安全性和代码质量"},{"href":"/zh/code-security/how-tos","title":"How-tos"},{"href":"/zh/code-security/how-tos/find-and-fix-code-vulnerabilities","title":"查找和修复代码漏洞"},{"href":"/zh/code-security/how-tos/find-and-fix-code-vulnerabilities/configure-code-scanning","title":"配置代码扫描"},{"href":"/zh/code-security/how-tos/find-and-fix-code-vulnerabilities/configure-code-scanning/configuring-default-setup-for-code-scanning","title":"配置代码扫描"}],"documentType":"article"},"body":"# 配置代码扫描的默认设置\n\n快速设置 code scanning 以自动查找 易受攻击的代码。\n\n我们建议您开始使用code scanning，并采用默认设置。 最初配置默认设置后，可以评估 code scanning 其工作原理，并对其进行自定义，以更好地满足需求。 有关详细信息，请参阅“[关于代码扫描的设置类型](/zh/code-security/concepts/code-scanning/setup-types)”。\n\n## 先决条件\n\n如果满足以下条件，存储库有资格进行 code scanning 的默认设置：\n\n* 已启用 GitHub Actions。\n* 它公开可见，或已启用 GitHub Code Security。\n\n## 配置存储库的默认设置\n\n> \\[!NOTE]\n> 如果对存储库中所有CodeQL支持的语言的分析失败，默认设置仍会启用，但在将另一种GitHub Actions支持的语言添加到存储库或手动重新配置默认设置之前，不会运行任何扫描或使用任何CodeQL分钟，且分析CodeQL支持的语言成功。\n\n1. 在 GitHub 上，导航到存储库的主页面。\n\n > \\[!NOTE]\n > 如果要在分支上配置默认设置，则必须首先启用 GitHub Actions。 若要启用GitHub Actions，请在存储库名称下单击“**操作”**，然后单击“**我了解我的工作流”，继续启用它们**。 请注意，这将在分支上启用所有现有工作流。\n\n2. 在仓库名称下，单击 “Settings”\\*\\*\\*\\*。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。\n\n \n\n3. 在边栏的“Security”部分中，单击“ Advanced Security”\\*\\*\\*\\*。\n\n4. 在“Code Security”下，“CodeQL analysis”右侧，选择“Set up”，然后单击“Default”。\\*\\*\\*\\*\\*\\*\\*\\*\n\n \n\n 然后，你将看到一个“CodeQL 默认配置”对话框，其中 code scanning 汇总了默认设置自动创建的配置。\n\n5. （可选）若要自定义 code scanning 设置，请单击“ ** 编辑**”。\n * 若要在默认设置执行的分析中添加或移除语言，请在“语言”部分选择或取消选择该语言。\n * 若要指定 CodeQL 要使用的查询套件，请在“查询套件”部分选择首选查询套件。\n\n6. 查看存储库上默认设置的设置，然后单击“ **启用 CodeQL**”。 这将触发一个工作流来测试新的自动生成的配置。\n\n > \\[!NOTE]\n > 如果要从高级设置切换到默认设置，则会看到一条警告，通知你默认设置将替代现有 code scanning 配置。 此警告意味着默认设置将禁用现有工作流文件并阻止任何 CodeQL 分析 API 上传。\n\n7. 如果存储库中的项目依赖于专用包注册表中的依赖项，则可以向其授予 code scanning 访问权限。 这可以提高分析的结果和质量。 请参阅“[授予安全功能访问专用注册表的权限](/zh/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries)”。\n\n8. （可选）调整影响默认设置的其他配置选项。 请参阅“[code scanning 的存储库属性](/zh/code-security/concepts/code-scanning/repository-properties)”。\n\n9. （可选）若要在启用后查看默认设置配置，请选择 ，然后单击“ ** 查看 CodeQL 配置**”。\n\n> \\[!NOTE]\n> 如果在启用默认设置的存储库中 6 个月未发生推送和拉取请求，则将禁用每周计划以节省 GitHub Actions 分钟。\n\n## 在自托管或 大型运行器\n\n上运行默认设置\n\n可以对自托管运行器或 CodeQL 托管运行器上使用所有 GitHub 支持的语言的默认设置。\n\n> \\[!NOTE] 启用默认设置时，Code scanning 将看到分配的运行器。 如果将运行程序分配给已在运行默认设置的存储库，则必须先禁用然后重新启用默认设置才能开始使用该运行程序。 如果你添加了运行程序并想要开始使用它，则可以手动更改配置，而无需先禁用然后重新启用默认设置。\n\n### 分配标签给自托管的运行程序\n\n若要为默认设置分配自承载运行程序，可以使用 默认 `code-scanning` 标签，也可以选择为它们提供自定义标签，以便单个存储库可以使用不同的运行程序。 有关为自托管运行器分配标签的信息，请参阅 [将标签与自托管运行程序结合使用](/zh/actions/hosting-your-own-runners/managing-self-hosted-runners/using-labels-with-self-hosted-runners)。\n\n将自定义标签分配给自托管运行器后，存储库可以使用这些运行器进行 code scanning 默认设置。\n\n还可以使用 security configurations 为 code scanning 的自托管运行器分配标签。 请参阅“[删除自定义安全配置](/zh/code-security/securing-your-organization/meeting-your-specific-security-needs-with-custom-security-configurations/creating-a-custom-security-configuration#creating-a-custom-security-configuration)”。\n\n### 分配 大型运行器\n\n若要分配 大型运行器，请命名运行器 `code-scanning`。 这会自动将`code-scanning`标签添加到大型运行器。 一个组织只能有一个带有 `code-scanning` 标签的 大型运行器，该运行器将处理组织内存储库中的所有 code scanning 作业，并可以访问运行器的组。 请参阅“[为默认设置配置更大的运行器](/zh/code-security/code-scanning/managing-your-code-scanning-configuration/configuring-larger-runners-for-default-setup#provisioning-organization-level-larger-runners-for-default-setup)”。\n\n### 确保构建支持\n\n默认设置使用 `none` 构建模式用于 C/C++、C#， Java 和 Rust，并使用 `autobuild` 构建模式用于其他已编译语言。 应配置自托管运行器，以确保可以运行 C/C++、C# 和 Swift 分析所需的所有命令。 JavaScript/TypeScript、Go、Ruby、Python 和 Kotlin 代码的分析目前不需要特殊配置。\n\n## 后续步骤\n\n配置成功运行至少一次后，可以开始检查和解决 code scanning 警报。 有关警报的详细信息 code scanning ，请参阅 [关于代码扫描警报](/zh/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts) 和 [访问存储库的代码扫描警报](/zh/code-security/code-scanning/managing-code-scanning-alerts/assessing-code-scanning-alerts-for-your-repository)。\n\n配置好默认设置code scanning后，您可以了解评估其效果的方式以及可以采取的下一步自定义措施。 有关详细信息，请参阅“[评估代码扫描的默认设置](/zh/code-security/code-scanning/enabling-code-scanning/evaluating-default-setup-for-code-scanning)”。\n\n可以在工具状态页上找到有关 code scanning 配置的详细信息，包括每个扫描的时间戳和扫描的文件百分比。 有关详细信息，请参阅“[使用工具状态页进行代码扫描](/zh/code-security/code-scanning/managing-your-code-scanning-configuration/about-the-tool-status-page)”。\n\n配置默认设置时，可能会遇到错误。 有关排查特定错误的信息，请参阅 [代码扫描分析错误疑难解答](/zh/code-security/code-scanning/troubleshooting-code-scanning)。"}