Skip to content
FunCoding

Search

Search docs, Skills and MCP

用 .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;不能仅靠忽略规则保证其他命令无法读取文件。