Escludere i file dall'utilizzo di Gemini Code Assist
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Gemini Code Assist supporta l'esclusione di file dal contesto per la generazione di codice, il completamento del codice, la trasformazione del codice e la chat. Per gli utenti Enterprise, è inclusa anche la personalizzazione del codice.
In molti scenari, avrai file o sottoalberi specifici che non vuoi
includere nel contesto.
Puoi escludere questi file utilizzando un file .aiexclude o .gitignore.
Configurare le impostazioni di esclusione contestuale
Questa sezione mostra come configurare le impostazioni per i file .aiexclude e
.gitignore.
Modificare il file .aiexclude con il file che preferisci
Per impostazione predefinita, l'esclusione del contesto è impostata per utilizzare .aiexclude. Per modificare questa impostazione
nel tuo IDE, segui questi passaggi:
VS Code
Nella barra delle attività, fai clic su
ImpostazioniGestisci >
Impostazioni.
Nella finestra Impostazioni, vai a Estensioni >
Gemini Code Assist. Scorri fino a trovare File di esclusione contestuale.
Nel campo di testo, modifica .aiexclude con la posizione che preferisci.
Il file che preferisci è ora impostato come file di esclusione del contesto.
IntelliJ
La configurazione delle impostazioni per i file .aiexclude e .gitignore non è
supportata negli IDE JetBrains.
Modificare l'esclusione del contesto di .gitignore
Per impostazione predefinita, il file .gitignore è abilitato per l'esclusione del contesto. Il file
deve trovarsi nella cartella di lavoro principale di
Gemini Code Assist. I file .gitignore che si trovano nelle sottodirectory
non verranno presi in considerazione o uniti.
Per disattivare l'esclusione dal contesto dei file .gitignore:
Nella barra delle attività, fai clic su
ImpostazioniGestisci >
Impostazioni.
Nella finestra Impostazioni, vai a Estensioni >
Gemini Code Assist. Scorri fino a trovare Context Exclusion Gitignore.
Deseleziona la casella di controllo.
I file .gitignore sono ora disabilitati per specificare i file che Gemini Code Assist deve ignorare.
Scrivere un file .aiexclude
Un file .aiexclude segue la stessa sintassi di un file .gitignore.
Esempi
Gli esempi seguenti mostrano come configurare un file .aiexclude:
Blocca tutti i file denominati apikeys.txt nella directory contenente il file .aiexclude o in una directory di livello inferiore:
apikeys.txt
Blocca tutti i file con l'estensione .key nella directory che contiene il file .aiexclude o in una directory di livello inferiore:
*.key
Blocca solo il file apikeys.txt nella stessa directory del file .aiexclude, ma non le sottodirectory:
/apikeys.txt
Blocca tutti i file nella directory my/sensitive/dir e in tutte le sottodirectory.
Il percorso deve essere relativo alla directory che contiene il file .aiexclude.
my/sensitive/dir/
Blocca tutti i file nella directory foo e nelle relative sottodirectory, ad eccezione del file
denominato bar.txt nella directory foo.
foo/*
!foo/bar.txt
Controllare l'accesso all'indice per la personalizzazione del codice
Per impostazione predefinita, la personalizzazione del codice indicizza tutti i
file di codice supportati
nei repository specificati.
Per evitare l'esposizione di codice che non vuoi venga utilizzato nel contesto, puoi utilizzare pattern di ramificazione per
controllare l'accesso all'indice
e utilizzare un ramo stabile, ad esempio main.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-10 UTC."],[[["\u003cp\u003eGemini Code Assist indexes all supported code files in your repositories by default, but you can exclude specific files or subtrees using an \u003ccode\u003e.aiexclude\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eAn \u003ccode\u003e.aiexclude\u003c/code\u003e file uses a similar syntax to \u003ccode\u003e.gitignore\u003c/code\u003e, but an empty file blocks all files in its directory and subdirectories, and negation with an exclamation point is not supported.\u003c/p\u003e\n"],["\u003cp\u003eYou can block specific files, file types, or entire directories by listing their names, extensions, or relative paths in the \u003ccode\u003e.aiexclude\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eIf a file is added to \u003ccode\u003e.aiexclude\u003c/code\u003e after being indexed, it will be removed from the index within 24 hours.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nGemini Code Assist supports excluding files from your context for code\ngeneration, code completion, code transformation, and chat. For Enterprise\nusers, this also includes code customization.\n\nIn many scenarios, you'll have specific files or subtrees that you don't want\nto have included in your context.\n\nYou can exclude these files through the use of an `.aiexclude` or `.gitignore`\nfile.\n| **Note:** For [code customization](/gemini-code-assist/docs/code-customization-overview) only the `.aiexclude` file is used.\n\nConfigure context exclusion settings\n\nThis section shows you how to configure settings for `.aiexclude` and\n`.gitignore` files.\n\nChange .aiexclude file to your preferred file\n\nBy default, context exclusion is set to use `.aiexclude`. To change this setting\nin your IDE, follow these steps: \n\nVS Code\n\n1. In the activity bar, click\n settings **Manage** \\\u003e\n **Settings**.\n\n2. In the **Settings** window, navigate to **Extensions** \\\u003e\n **Gemini Code Assist** . Scroll until you find **Context Exclusion File**.\n\n3. In the text field, change `.aiexclude` to your preferred location.\n\nYour preferred file is now set as the context exclusion file.\n\nIntelliJ\n\nConfiguring settings for `.aiexclude` and `.gitignore` files isn't\nsupported in JetBrains IDEs.\n\nChange .gitignore context exclusion\n\nBy default, the `.gitignore` file is enabled for context exclusion. The file\nmust be located in the root working folder for\nGemini Code Assist. `.gitignore` files located in subdirectories\nwon't be considered or merged.\n\nTo disable `.gitignore` files from context exclusion, follow these steps:\n\n1. In the activity bar, click\n settings **Manage** \\\u003e\n **Settings**.\n\n2. In the **Settings** window, navigate to **Extensions** \\\u003e\n **Gemini Code Assist** . Scroll until you find **Context Exclusion Gitignore**.\n\n3. Unselect the checkbox.\n\n `.gitignore` files are now disabled for specifying file Gemini Code Assist to ignore.\n\nWrite an `.aiexclude` file **Note:** In the event that a conflict exists between `.aiexclude` and `.gitignore`, the `.aiexclude` directive preempts `.gitignore` directives.\n\nAn `.aiexclude` file follows the same syntax as a `.gitignore` file.\n\nExamples\n\nThe following examples demonstrate how you can configure an `.aiexclude` file:\n\n- Block all files named `apikeys.txt` at or below the directory that contains\n the `.aiexclude` file:\n\n apikeys.txt\n\n- Block all files with the `.key` file extension at or below the directory that\n contains the `.aiexclude` file:\n\n *.key\n\n- Block only the `apikeys.txt`file at the same directory as the `.aiexclude`\n file, but not any subdirectories:\n\n /apikeys.txt\n\n- Block all files in the directory `my/sensitive/dir` and all subdirectories.\n The path should be relative to the directory that contains the `.aiexclude`\n file.\n\n my/sensitive/dir/\n\n- Blocks all the files in directory `foo` and its subdirectories except file\n named `bar.txt` in the foo directory.\n\n foo/*\n !foo/bar.txt\n\nControl access to index for code customization\n\nBy default, code customization indexes all the\n\n[supported code files](/gemini-code-assist/docs/code-customization-overview#limitations)\nin your specified repositories.\n\nTo prevent exposure of code that you don't want to be used in the context, you\ncan use branch patterns to\n\n[control access to your index](/gemini-code-assist/docs/code-customization#control_access_to_your_index_using_repository_groups)\nand use a stable branch, such as `main`.\n\nAlternatively, you can also exclude files from the context by\n[creating an `.aiexclude` file](#write_an_aiexclude_file)."]]
