跳至主要内容

解决语言问题

列出已安装的 CodeQL 提取器包。

谁可以使用此功能?

CodeQL 可用于以下类型的仓库

本文内容

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

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

概要

Shell
codeql resolve languages <options>...

描述

列出已安装的 CodeQL 提取器包。

当使用选择的 JSON 输出运行时,此命令可以为每个提取器包名称报告多个位置。发生这种情况时,这意味着该包在一个搜索元素中具有冲突的位置,因此实际上无法解析。调用者可以使用实际位置来格式化适当的错误消息。

选项

主要选项

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

可以找到提取器包的目录列表。这些目录可以是提取器包本身,也可以是包含提取器作为直接子目录的目录。

如果路径包含多个目录树,则它们的顺序定义它们之间的优先级:如果目标语言在多个目录树中匹配,则首先给出的目录树优先。

与 CodeQL 工具链捆绑在一起的提取器将始终被找到,但是如果您需要使用单独分发的提取器,则需要使用此选项(或者更好的是,在每个用户的配置文件中设置--search-path)。

(注意:在 Windows 上,路径分隔符为;)。

--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起可用。