{"meta":{"title":"CodeQL 查询包","intro":"你可以从不同的内置 CodeQL 查询套件中进行选择，以便在你的 CodeQLcode scanning 设置中使用。","product":"安全性和代码质量","breadcrumbs":[{"href":"/zh/code-security","title":"安全性和代码质量"},{"href":"/zh/code-security/concepts","title":"Concepts"},{"href":"/zh/code-security/concepts/code-scanning","title":"代码扫描"},{"href":"/zh/code-security/concepts/code-scanning/codeql","title":"CodeQL"},{"href":"/zh/code-security/concepts/code-scanning/codeql/query-packs","title":"查询包"}],"documentType":"article"},"body":"# CodeQL 查询包\n\n你可以从不同的内置 CodeQL 查询套件中进行选择，以便在你的 CodeQLcode scanning 设置中使用。\n\n## 关于 CodeQL 包\n\nCodeQL 包用于创建、共享、依赖和运行 CodeQL 查询和库。 您可以通过下载他人创建的包并在代码库中运行它们，来自定义您的 CodeQL 分析。\n\n每个 CodeQL 包都需要其根目录中的一个 `qlpack.yml` 文件，该目录指定：\n\n* 如何编写查询\n* 依赖于其他 CodeQL 包和库\n* 查询套件定义\n\n有关 `qlpack.yml` 属性的详细信息，请参阅 [使用 CodeQL 包自定义分析](/zh/code-security/tutorials/customize-code-scanning/customize-analysis)。\n\n此外，包 CodeQL 可以包含：\n\n* 自定义查询（`.ql` 文件）\n* 库文件\n* 查询套件\n* Metadata\n\nCodeQL CLI 捆绑包包含由 GitHub 专家、安全研究人员和社区贡献者维护的查询。 如果要运行其他组织开发的查询， CodeQL 查询包提供了一种高效可靠的方法来下载和运行查询，而模型包（公开预览）可用于扩展 code scanning 分析，以识别默认情况下不支持的库和框架。\n\n## CodeQL包类型\n\n有三种类型的 CodeQL 包：查询包、库包和模型包。\n\n* 查询包包含一组可在 CodeQL 数据库上执行的预编译查询。 查询包是为运行而设计的。 发布查询包时，除了查询源外，捆绑包还包括每个查询的所有可传递依赖项和预编译表示形式。 这可确保一致且高效地执行包中的查询。\n\n* 库包旨在供查询包（或其他库包）使用，并且不包含查询本身。 库不会单独编译。\n\n* 模型包可用于扩展 code scanning 分析，以识别默认情况下不支持的库和框架。 模型包当前处于公开预览阶段，后续可能会发生变化。 在公开预览期间，模型包可用于进行C/C++、C#、Java/Kotlin、Python、Ruby 和 Rust分析。 有关创建自己的模型包的详细信息，请参阅 [创建并使用 CodeQL 包](/zh/code-security/tutorials/customize-code-scanning/create-and-work-with-codeql-packs#creating-a-codeql-model-pack)。\n\n## 在何处查找查询包\n\n所有受支持语言的标准CodeQL包都发布在[Container registry](https://github.com/orgs/codeql/packages)中。 如果你以标准方式安装了 CodeQL CLI，使用 CodeQL CLI 捆绑包，核心查询包已经下载并可供你使用。 它们分别是：\n\n* `codeql/cpp-queries`\n* `codeql/csharp-queries`\n* `codeql/go-queries`\n* `codeql/java-queries`\n* `codeql/javascript-queries`\n* `codeql/python-queries`\n* `codeql/ruby-queries`\n* `codeql/swift-queries`\n\n有关已发布查询包和不同 CodeQL 版本之间的兼容性的详细信息，请参阅 [CodeQL 查询包参考](/zh/code-security/reference/code-scanning/codeql/codeql-cli/codeql-query-packs#codeql-pack-compatibility)。\n\n还可以使用该 CodeQL CLI 包创建自己的 CodeQL 包、将依赖项添加到包，以及安装或更新依赖项。\n\n## 发布和共享 CodeQL 包\n\n可以通过以下方法与更广泛的 CodeQL 社区共享自定义查询：\n\n* 发布到 GitHub Packages：将您的包公开，以便其他用户发现并使用。\n* 为 CodeQL 存储库做贡献：通过向官方存储库打开拉取请求，提交将使更广泛的社区受益的查询。\n\n有关发布和下载 CodeQL 包的详细信息，请参阅 [发布及使用 CodeQL 包](/zh/code-security/how-tos/find-and-fix-code-vulnerabilities/scan-from-the-command-line/publish-and-use-packs)。\n\n有关如何为CodeQL做贡献的信息，请参阅[为CodeQL做贡献](https://github.com/github/codeql/blob/main/CONTRIBUTING.md)。"}