忽略文件

本文介绍 Gemini CLI 中的 .geminiignore 功能。

Gemini CLI 支持类似 .gitignore（Git 使用）和 .aiexclude（Gemini Code Assist 使用）的自动忽略机制。将路径写入 .geminiignore 后，支持该功能的工具会排除这些文件或目录，但其他服务（如 Git）仍能看到它们。

工作原理

当你在 .geminiignore 中添加路径时，遵循该文件的工具会自动跳过匹配的文件与目录。例如使用 read_many_files 时，列入 .geminiignore 的路径会被自动过滤。

.geminiignore 基本遵循 .gitignore 约定：

• 空行与 # 开头的行会被忽略；
• 支持标准 glob 模式（*、?、[] 等）；
• 以 / 结尾表示仅匹配目录；
• 以 / 开头表示相对于 .geminiignore 文件所在路径；
• ! 用于取反某个模式。

可随时修改 .geminiignore，但需重启 Gemini CLI 会话才能生效。

使用方法

启用 .geminiignore：

1. 在项目根目录创建 .geminiignore 文件。

将路径加入忽略列表：

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

示例

忽略目录与文件：

# 忽略 /packages/ 目录及其子目录
/packages/

# 忽略 apikeys.txt
apikeys.txt

使用通配符：

# 忽略所有 .md 文件
*.md

结合 ! 取消忽略：

# 忽略所有 .md 文件，但保留 README.md
*.md
!README.md

若要恢复访问，只需删除 .geminiignore 中对应条目。