解析语言

注意

此内容描述了 CodeQL CLI 的最新版本。有关此版本的详细信息，请参阅 https://github.com/github/codeql-cli-binaries/releases 。

若要查看早期版本中此命令可用选项的详细信息，请在终端中使用 --help 选项运行命令。

概要

Shell

codeql resolve languages <options>...

codeql resolve languages <options>...

Description

列出已安装的 CodeQL 提取程序包。

在已选中 JSON 输出的情况下运行时，此命令可以报告每个提取程序包名称的多个位置。发生这种情况意味着包在单个搜索元素中具有互相冲突的位置，因此无法解析包。调用方可以使用实际位置为相应的错误消息设置格式。

选项

主要选项

`--search-path=<dir>[:<dir>...]`

可在其中找到提取程序包的目录列表。目录可以是提取程序包本身，也可以是包含提取程序作为直接子目录的目录。

如果路径包含多个目录树，则目录树的顺序定义了各自之间的优先级：如果目标语言在多个目录树中匹配，则给定的第一个目录树优先。

与 CodeQL 工具链本身捆绑的提取程序始终都能找到，但如果需要单独使用分布式提取程序，则需要提供此选项（或者更佳方式是，在每用户配置文件中设置 --search-path）。

（注意：在 Windows 上，路径分隔符为 ;）。

`--[no-]filter-to-languages-with-queries`

仅列出具有默认查询的语言。

自 v2.23.1 起可用。

`--format=<fmt>`

选择输出格式。选项包括：

          `text`              _（默认）_：将提取程序包的路径打印到标准输出。

          `json`：将提取程序包的路径作为 JSON 字符串打印。

          `betterjson`：将提取程序包的详细信息作为 JSON 字符串打印。

常用选项

`-h, --help`

显示此帮助文本。

`-J=<opt>`

          \[高级] 向运行命令的 JVM 提供选项。

（请注意，无法正确处理包含空格的选项。）

`-v, --verbose`

以增量方式增加输出的进度消息数。

`-q, --quiet`

以增量方式减少输出的进度消息数。

`--verbosity=<level>`

          \[高级] 明确将详细级别设置为 errors、warnings、progress、progress+、progress++、progress+++ 之一。 重写 `-v` 和 `-q`。

`--logdir=<dir>`

          \[高级] 将详细日志写入指定目录中的一个或多个文件，生成的文件名包含时间戳和正在运行的子命令名称。

（要使用可以完全控制的名称编写日志文件，请根据需要提供 --log-to-stderr 并重定向 stderr。）

`--common-caches=<dir>`

          \[高级] 控制磁盘上缓存数据的位置，这些数据将在 CLI 的多次运行之间保留，例如下载的 QL 包和编译的查询计划。 如果未明确设置，则默认为用户主目录中名为 `.codeql` 的目录；如果尚不存在，则会创建该目录。

自 v2.15.2 起可用。

谁可以使用此功能？

本文内容

概要