用 .geminiignore 排除文件
控制支持忽略机制的工具输入,并区分文件筛选与真实访问权限。
This page has not been translated into English yet. The original Chinese version is shown below.
在项目根目录创建 .geminiignore,排除无需参与工具操作的生成产物、存档或敏感文件。只对遵守该机制的工具有效,例如 @ 引用会跳过匹配路径;文件仍存在,也仍能被 Git 等其他服务看见。
模式规则
| 写法 | 含义 |
|---|---|
空行或以 # 开头 | 忽略该行 |
*、?、[] | 标准 glob 匹配 |
末尾 / | 仅目录 |
开头 / | 相对于该 .geminiignore 所在位置锚定 |
! | 对排除模式取反 |
# Exclude the archive directory
/archive/
# Exclude this file
apikeys.txt
# Keep README.md while excluding other Markdown files
*.md
!README.md应用变化
编辑文件后需要重启 Gemini CLI 会话;想重新包含某路径时删除相应规则。检查实际工具结果,尤其是多层 glob 和例外组合,不要只检查文件存在。
.geminiignore 不等于权限策略或沙箱,也不改变仓库的 .gitignore。需要真正限制工具能力时,应使用权限、受信任目录和 sandbox;不能仅靠忽略规则保证其他命令无法读取文件。