配置代码扫描的默认设置

建议在默认设置下开始使用 code scanning。在最初配置了默认设置后，你可以评估 code scanning，看其是否正常工作，并对其进行定制化设置，以更好地满足需求。有关详细信息，请参阅“关于代码扫描的设置类型”。

先决条件

如果你的存储库满足以下条件，则符合使用 code scanning 的默认设置的条件：

已启用 GitHub Actions。
它公开可见，或已启用 GitHub Code Security。

配置存储库的默认设置

注意

如果存储库中对所有 CodeQL 支持的语言分析失败，仍将启用默认设置，但其不会运行任何扫描或使用任何 GitHub Actions 分钟，直到将另一个 CodeQL 支持的语言添加到存储库或手动重新配置默认设置，并且对 CodeQL 支持的语言分析将成功。

在 GitHub 上，导航到存储库的主页面。

注意

如果要在分支上配置默认设置，必须先启用 GitHub Actions。要启用 GitHub Actions，在仓库名称下，单击“ Actions”，然后单击“I understand my workflows, go ahead and enable them”********。请注意，这将在分支上启用所有现有工作流。
在仓库名称下，单击 “Settings”****。如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。
在边栏的“Security”部分中，单击“ Advanced Security”****。
在“Code Security”下，“CodeQL analysis”右侧，选择“Set up”，然后单击“Default”。********

然后，你将看到“CodeQL 默认配置”对话框，其中汇总了默认设置自动创建的 code scanning 配置。
或者，若要自定义code scanning设置，请单击“ Edit”****。
- 若要在默认设置执行的分析中添加或移除语言，请在“语言”部分选择或取消选择该语言。
- 若要指定要使用的 CodeQL 查询套件，请在“查询套件”部分选择首选的查询套件。
查看存储库中默认设置的设置，然后单击“启用 CodeQL”。这将触发一个工作流来测试新的自动生成的配置。

注意

如果要从高级设置切换到默认设置，则可看到一条警告，通知你默认设置将替代现有的 code scanning 配置。该警告意味着默认设置将禁用现有工作流文件，并阻止任何 CodeQL 分析 API 上传。
如果存储库中的项目依赖于专用包注册表中的依赖项，则可以授予 code scanning 访问这些依赖项的权限。这可以提高分析的结果和质量。请参阅“授予安全功能访问专用注册表的权限”。
（可选）调整影响默认设置的其他配置选项。请参阅“code scanning 的存储库属性”。
（可选）要在启用后查看默认设置配置，请选择“”，然后单击“ View CodeQL configuration”****。