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 du contexte utilisé 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, procédez comme suit :
VS Code
Dans la barre d'activité, cliquez sur Settings (Paramètres) Manage (Gérer) >Settings (Paramètres).
Dans la fenêtre Settings (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 de contexte des fichiers .gitignore, procédez comme suit :
Dans la barre d'activité, cliquez sur Settings (Paramètres) Manage (Gérer) >Settings (Paramètres).
Dans la fenêtre Settings (Paramètres), accédez à Extensions>Gemini Code Assist. Faites défiler l'écran jusqu'à Exclusion de contexte Gitignore.
Désélectionnez la case.
Désormais, les fichiers .gitignore ne sont plus utilisés pour indiquer les fichiers à exclure du contexte par Gemini Code Assist.
É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 l'un de ses sous-répertoires :
apikeys.txt
Bloquez tous les fichiers portant l'extension de fichier .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 spécifié par rapport au dossier dans lequel se trouve le fichier .aiexclude.
my/sensitive/dir/
Bloquez 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/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/03 (UTC)."],[[["\u003cp\u003eGemini Code Assist indexes all supported code files in specified repositories by default, but users can exclude certain files.\u003c/p\u003e\n"],["\u003cp\u003eAn \u003ccode\u003e.aiexclude\u003c/code\u003e file, similar in syntax to \u003ccode\u003e.gitignore\u003c/code\u003e, can be created to exclude specific files or subtrees from being indexed.\u003c/p\u003e\n"],["\u003cp\u003eAn empty \u003ccode\u003e.aiexclude\u003c/code\u003e file blocks all files within its directory and sub-directories, while patterns within the \u003ccode\u003e.aiexclude\u003c/code\u003e file allow excluding specific file names, extensions, or directory paths.\u003c/p\u003e\n"],["\u003cp\u003eFiles added to the \u003ccode\u003e.aiexclude\u003c/code\u003e file are dropped from the index within 24 hours if they were previously included.\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/docs/codeassist/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/docs/codeassist/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/docs/codeassist/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)."]]
