注意
此内容描述了 CodeQL CLI 的最新发布版本。有关此版本的更多信息,请参阅 https://github.com/github/codeql-cli-binaries/releases。
要查看早期版本中此命令可用的选项详情,请在终端中使用 --help 选项运行该命令。
概要
codeql resolve extractor --language=<lang> <options>...
codeql resolve extractor --language=<lang> <options>...
描述
[Deep plumbing] 确定给定语言要使用的提取器包。
选项
主要选项
-l, --language=<lang>
[必需] 要定位的提取器名称。
--search-path=<dir>[:<dir>...]
一个目录列表,提取器包可能位于其下。这些目录可以是提取器包本身,也可以是包含提取器的直接子目录的目录。
如果路径包含多个目录树,它们的顺序决定了优先级:如果目标语言在多个目录树中匹配,则先给出的那个优先。
随 CodeQL 工具链一起捆绑的提取器始终会被找到,但如果需要使用单独分发的提取器,则需提供此选项(或者更好地,在每用户配置文件中设置 --search-path)。
(注意:在 Windows 上,路径分隔符是 ;)。
--just-check
不输出任何内容,但如果找到提取器则以代码 0 退出,否则以代码 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 起可用。