排除不想讓 Gemini Code Assist 使用的檔案

Gemini Code Assist 支援從程式碼生成、程式碼自動完成、程式碼轉換和對話的環境中排除檔案。如果是 Enterprise 使用者,還能自訂程式碼。

在許多情況下,您會有一些不想納入情境的特定檔案或子樹狀結構。

您可以使用 .aiexclude 或 .gitignore 檔案排除這些檔案。Gemini CLI 使用者可以透過 .geminiignore 檔案排除檔案。

設定內容排除條件

本節說明如何設定 .aiexclude 和 .gitignore 檔案。

將 .aiexclude 檔案變更為偏好的檔案

根據預設,內容排除條件會設為使用 .aiexclude。如要在 IDE 中變更這項設定,請按照下列步驟操作:

VS Code

  1. 在活動列中,依序點選「設定」「管理」>「設定」。

  2. 在「Settings」視窗中,依序前往「Extensions」>「Gemini Code Assist」。捲動畫面,找出「Context Exclusion File」。

  3. 在文字欄位中,將 .aiexclude 變更為偏好的位置。

偏好的檔案現在已設為內容排除檔案。

IntelliJ

JetBrains IDE 不支援設定 .aiexclude 和 .gitignore 檔案。

變更 .gitignore 內容排除條件

根據預設,系統會啟用 .gitignore 檔案,排除脈絡資訊。檔案必須位於 Gemini Code Assist 的根工作資料夾中。系統不會考慮或合併子目錄中的 .gitignore 檔案。

如要停用從內容排除 .gitignore 檔案,請按照下列步驟操作:

  1. 在活動列中,依序點選「設定」「管理」>「設定」。

  2. 在「Settings」視窗中,依序前往「Extensions」>「Gemini Code Assist」。捲動畫面,直到找到「Context Exclusion Gitignore」。

  3. 取消勾選核取方塊。

    .gitignore 檔案現在已停用,無法指定 Gemini Code Assist 要忽略的檔案。

撰寫 .aiexclude 檔案

.gitignore

.aiexclude 檔案所遵循的語法與 .gitignore 檔案相同。

範例

以下範例說明如何設定 .aiexclude 檔案:

  • 封鎖含有 .aiexclude 檔案的目錄中或其下,所有名為 apikeys.txt 的檔案:

    apikeys.txt
    
  • 封鎖含有 .aiexclude 檔案的目錄中或其下方的所有 .key 副檔名檔案:

    *.key
    
  • 只封鎖與 .aiexclude 檔案位於相同目錄的 apikeys.txt 檔案,但不封鎖任何子目錄:

    /apikeys.txt
    
  • 封鎖目錄 my/sensitive/dir 和所有子目錄中的所有檔案。 路徑應與包含 .aiexclude 檔案的目錄相對。

    my/sensitive/dir/
    
  • 封鎖目錄 foo 及其子目錄中的所有檔案,但 foo 目錄中名為 bar.txt 的檔案除外。

    foo/*
    !foo/bar.txt
    

控管程式碼自訂索引的存取權

自訂程式碼功能預設會為指定存放區中所有支援的程式碼檔案建立索引。

如要避免在情境中顯示不想使用的程式碼,可以使用分支版本模式控管索引的存取權,並使用穩定分支版本,例如 main。

或者,您也可以建立 .aiexclude 檔案,從內容中排除檔案。