文件忽略规则

配置 qwenignore 与兼容文件，明确适用工具、glob 语义和重启要求。

This page has not been translated into English yet. The original Chinese version is shown below.

忽略文件缩小支持该机制的工具的读取或扫描范围。例如 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 或外部服务不会读取同一路径。需要禁止访问时使用权限规则与对应沙箱，并验证实际执行路径。