文件忽略规则
配置 qwenignore 与兼容文件,明确适用工具、glob 语义和重启要求。
忽略文件缩小支持该机制的工具的读取或扫描范围。例如 read_many_files 会排除命中规则的路径;Git 等其他服务仍能看见这些文件。它不是文件权限或沙箱。
默认与自定义文件
默认识别项目根 .qwenignore、.agentignore、.aiignore。后两者来自 context.fileFiltering.customIgnoreFiles 默认兼容列表;可改成所需列表:
{
"context": {
"fileFiltering": {
"customIgnoreFiles": [".cursorignore"]
}
}
}自定义路径相对项目根。只要 respectQwenIgnore 启用,.qwenignore 仍包含在内,不需要再写进 customIgnoreFiles。
常用规则
/archive/
apikeys.txt
*.md
!README.md开头 / 相对忽略文件锚定;末尾 / 只匹配目录。支持 *、?、[],! 反转匹配;空行和 # 开头行不生效。上例排除归档、指定文件和 Markdown,再对 README.md 例外处理。
修改后重启 Qwen 会话才应用新规则。取消忽略时删除对应行,再重新核对工具实际结果。
不要作为秘密隔离
仅遵守 Qwen 忽略规则的工具受影响,不能据此保证其他工具、shell 或外部服务不会读取同一路径。需要禁止访问时使用权限规则与对应沙箱,并验证实际执行路径。