注意：本文已于 2023 年 1 月从 CodeQL 文档网站迁移。
关于查询引用文件
查询引用文件是文本文件，用于定义要测试的一个查询的位置。
如果要告知 test run 子命令运行不属于测试目录的查询，请使用查询引用文件。
可通过两种方式指定要作为测试运行的查询：
- 使用查询引用文件指定要测试的查询的位置。 在为旨在识别真实代码库中的问题的警报和路径查询创建测试时，这非常有用。 可以创建多个测试代码目录，每个目录都侧重于查询的不同方面。 然后将查询引用文件添加到每个测试代码目录，以指定要测试的查询。
- 将查询直接添加到测试目录。
在显式编写查询以测试 QL 库的行为时，这些查询通常很有用。 通常，这些查询只包含对库谓词的几个调用，将它们包装在一个
select语句中，以便测试其输出。
定义查询引用文件
每个查询引用文件 (.qlref) 都包含一行，用于定义查找一个查询的位置。 必须相对于包含查询的 CodeQL 包的根位置来定义该位置。
通常，这是包含 .qlref 的 CodeQL 包、在测试包的 dependencies 块中指定的 CodeQL 包，或 CodeQL 包的传递依赖项。
应在所有操作系统的路径中使用正斜杠，以确保系统之间的兼容性。
示例
用于测试 JavaScript 警报查询的查询引用文件：DeadAngularJSEventListener.qlref
javascript/ql/test 处的 CodeQL 包的 qlpack.yml 文件 https://github.com/github/codeql/blob/main/javascript/ql/test/qlpack.yml 将 codeql/javascript-queries 定义为依赖项。 因此，查询引用文件定义查询相对于 codeql/javascript-queries CodeQL 包的位置：
AngularJS/DeadAngularJSEventListener.ql
有关其他示例，请参阅测试自定义查询。