zen-code-docs/website/content/zh/gemini-ignore.md

忽略文件

本文档概述了 Qwen Code 的 Gemini Ignore（.geminiignore）功能。

Qwen Code 支持自动忽略文件，类似于 Git 使用的 .gitignore 和 Gemini Code Assist 使用的 .aiexclude。将路径添加到你的 .geminiignore 文件中，可以将这些路径排除在支持此功能的工具之外，但这些文件对其他服务（如 Git）仍然可见。

工作原理

当你在 .geminiignore 文件中添加路径时，支持该文件的工具会在操作中自动排除匹配的文件和目录。例如，当你使用 read_many_files 命令时，所有在 .geminiignore 文件中定义的路径都会被自动忽略。

大部分情况下，.geminiignore 遵循与 .gitignore 文件相同的规则：

• 空行以及以 # 开头的行会被忽略。
• 支持标准的通配符模式（如 *、? 和 []）。
• 路径末尾加上 / 表示只匹配目录。
• 路径开头加上 / 表示该路径是相对于 .geminiignore 文件的位置。
• 使用 ! 可以对模式进行取反。

你可以随时更新 .geminiignore 文件。要使更改生效，需要重启你的 Qwen Code 会话。

如何使用 .geminiignore

要启用 .geminiignore：

1. 在你的项目根目录下创建一个名为 .geminiignore 的文件。

要将文件或目录添加到 .geminiignore：

1. 打开你的 .geminiignore 文件。
2. 添加你想要忽略的路径或文件，例如：/archive/ 或 apikeys.txt。

.geminiignore 示例

你可以使用 .geminiignore 来忽略目录和文件：

# 排除你的 /packages/ 目录及其所有子目录
/packages/

# 排除你的 apikeys.txt 文件
apikeys.txt

你可以在 .geminiignore 文件中使用通配符 *：

# 排除所有 .md 文件
*.md

最后，你可以使用 ! 来将文件和目录从排除列表中恢复：

# 排除所有 .md 文件，但 README.md 除外
*.md
!README.md

要从 .geminiignore 文件中移除路径，只需删除相应的行。