# 文件忽略规则

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

- 网址：https://funcoding.ai/agents/qwen-code/configuration/ignore-files/
- 核实日期：2026-10-08（命令、配置和价格以官方文档为准）
- 官方来源：[Qwen Code 官方文档：Ignoring Files](https://github.com/QwenLM/qwen-code/blob/main/docs/users/configuration/qwen-ignore.md)

---
忽略文件缩小支持该机制的工具的读取或扫描范围。例如 read_many_files 会排除命中规则的路径；Git 等其他服务仍能看见这些文件。它不是文件权限或沙箱。

## 默认与自定义文件

默认识别项目根 `.qwenignore`、`.agentignore`、`.aiignore`。后两者来自 `context.fileFiltering.customIgnoreFiles` 默认兼容列表；可改成所需列表：

```json
{
  "context": {
    "fileFiltering": {
      "customIgnoreFiles": [".cursorignore"]
    }
  }
}
```

自定义路径相对项目根。只要 respectQwenIgnore 启用，`.qwenignore` 仍包含在内，不需要再写进 customIgnoreFiles。

## 常用规则

```gitignore
/archive/
apikeys.txt
*.md
!README.md
```

开头 `/` 相对忽略文件锚定；末尾 `/` 只匹配目录。支持 `*`、`?`、`[]`，`!` 反转匹配；空行和 `#` 开头行不生效。上例排除归档、指定文件和 Markdown，再对 README.md 例外处理。

修改后重启 Qwen 会话才应用新规则。取消忽略时删除对应行，再重新核对工具实际结果。

## 不要作为秘密隔离

仅遵守 Qwen 忽略规则的工具受影响，不能据此保证其他工具、shell 或外部服务不会读取同一路径。需要禁止访问时使用[权限规则](https://funcoding.ai/agents/qwen-code/configuration/permissions/)与对应[沙箱](https://funcoding.ai/agents/qwen-code/configuration/sandbox-troubleshooting/)，并验证实际执行路径。