Exclure des fichiers de l'utilisation par Gemini Code Assist
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Gemini Code Assist permet d'exclure des fichiers de votre contexte pour la génération, la complétion et la transformation de code, ainsi que pour le chat. Pour les utilisateurs Enterprise, cela inclut également la personnalisation du code.
Dans de nombreux cas, vous aurez des fichiers ou des sous-arborescences spécifiques que vous ne souhaitez pas inclure dans votre contexte.
Vous pouvez exclure ces fichiers à l'aide d'un fichier .aiexclude ou .gitignore.
Configurer les paramètres d'exclusion de contexte
Cette section vous explique comment configurer les paramètres des fichiers .aiexclude et .gitignore.
Remplacer le fichier .aiexclude par le fichier de votre choix
Par défaut, l'exclusion de contexte est définie sur .aiexclude. Pour modifier ce paramètre dans votre IDE :
VS Code
Dans la barre d'activité, cliquez sur ParamètresGérer > Paramètres.
Dans la fenêtre Paramètres, accédez à Extensions > Gemini Code Assist. Faites défiler l'écran jusqu'à Fichier d'exclusion de contexte.
Dans le champ de texte, remplacez .aiexclude par l'emplacement de votre choix.
Le fichier de votre choix est désormais défini comme fichier d'exclusion du contexte.
IntelliJ
La configuration des paramètres pour les fichiers .aiexclude et .gitignore n'est pas prise en charge dans les IDE JetBrains.
Modifier l'exclusion de contexte .gitignore
Par défaut, le fichier .gitignore est activé pour l'exclusion de contexte. Le fichier doit se trouver dans le dossier de travail racine de Gemini Code Assist. Les fichiers .gitignore situés dans des sous-répertoires ne seront pas pris en compte ni fusionnés.
Pour désactiver l'exclusion contextuelle des fichiers .gitignore :
Dans la barre d'activité, cliquez sur ParamètresGérer > Paramètres.
Dans la fenêtre Paramètres, accédez à Extensions > Gemini Code Assist. Faites défiler l'écran jusqu'à Context Exclusion Gitignore.
Décochez la case.
Les fichiers .gitignore sont désormais désactivés pour spécifier les fichiers que Gemini Code Assist doit ignorer.
Écrire un fichier .aiexclude
Un fichier .aiexclude suit la syntaxe suivante :
Exemples
Les exemples suivants montrent comment configurer un fichier .aiexclude :
Bloquez tous les fichiers nommés apikeys.txt dans le répertoire contenant le fichier .aiexclude ou dans un sous-répertoire :
apikeys.txt
Bloquez tous les fichiers portant l'extension .key dans le répertoire contenant le fichier .aiexclude ou dans l'un de ses sous-répertoires :
*.key
Bloquez uniquement le fichier apikeys.txt dans le même répertoire que le fichier .aiexclude, mais pas les sous-répertoires :
/apikeys.txt
Bloquez tous les fichiers du répertoire my/sensitive/dir et de tous ses sous-répertoires.
Le chemin d'accès doit être relatif au répertoire contenant le fichier .aiexclude.
my/sensitive/dir/
Bloque tous les fichiers du répertoire foo et de ses sous-répertoires, à l'exception du fichier nommé bar.txt dans le répertoire foo.
foo/*
!foo/bar.txt
Contrôler l'accès à l'index pour la personnalisation du code
Par défaut, la personnalisation du code indexe tous les fichiers de code compatibles dans les dépôts que vous avez spécifiés.
Pour éviter d'exposer du code que vous ne souhaitez pas utiliser dans le contexte, vous pouvez utiliser des modèles de branche pour contrôler l'accès à votre index et utiliser une branche stable, telle que main.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/31 (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)."]]
