使用 .aiExclude 文件配置上下文共享

通过在项目中添加 .aiexclude 文件,您可以控制应向 IDX 中的 Gemini 隐藏代码库中的哪些文件。与 .gitignore 文件类似,.aiexclude 文件会跟踪不应与 IDX 中的 Gemini 共享的文件,包括聊天体验以及在编辑器中运行的 AI 功能。.aiexclude 文件对包含它的目录或其下的文件执行操作。

启用代码库索引后,Gemini 不会将 .aiexclude 涵盖的文件编入索引。此外,.aiexclude 还会通过以下方式影响所涵盖文件的内嵌辅助:

  • 代码补全:修改覆盖的文件时,建议的代码补全功能不可用。
  • 内嵌协助:您可以生成新代码,但无法在修改被覆盖的文件时修改现有代码。

如何写入 .aiexclude 文件

.aiexclude 文件遵循的语法与 .gitignore 文件相同,但存在以下差异:

  • 空 .aiexclude 文件屏蔽了其目录和所有子目录中的所有文件。这与包含 **/* 的文件相同。
  • .aiexclude 文件不支持否定运算符(以 ! 作为前缀格式)。

示例

下面是 .aiexclude 文件配置示例:

禁止位于包含 .aiexclude 文件的目录或其下级所有名为 apikeys.txt 的文件:

apikeys.txt

阻止 .aiexclude 文件所在目录或其子目录中包含 .key 文件扩展名的所有文件:

*.key

仅阻止与 .aiexclude 位于同一目录中的 apikeys.txt 文件,但不阻止任何子目录。

/apikeys.txt

阻止目录 my/sensitive/dir 和所有子目录中的所有文件。该路径应相对于包含 .aiexclude 文件的目录。

my/sensitive/dir/