Исключить файлы из использования Gemini Code Assist
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Gemini Code Assist поддерживает исключение файлов из контекста для генерации кода, автодополнения кода, преобразования кода и чата. Для пользователей Enterprise это также включает настройку кода.
Во многих сценариях у вас будут определенные файлы или поддеревья, которые вы не захотите включать в свой контекст.
Вы можете исключить эти файлы с помощью файла .aiexclude или .gitignore .
Настройте параметры исключения контекста
В этом разделе показано, как настроить параметры файлов .aiexclude и .gitignore .
Измените файл .aiexclude на нужный вам файл.
По умолчанию для исключения контекста используется .aiexclude . Чтобы изменить этот параметр в вашей IDE, выполните следующие действия:
VS Код
На панели действий нажмите «Настройки» >«Управление» > «Настройки» .
В окне настроек перейдите в раздел «Расширения» > «Gemini Code Assist» . Прокрутите список, пока не найдёте «Файл исключения контекста» .
В текстовом поле измените .aiexclude на предпочитаемое вами местоположение.
Ваш предпочитаемый файл теперь установлен как файл исключения контекста.
IntelliJ
Настройка параметров для файлов .aiexclude и .gitignore не поддерживается в IDE JetBrains.
Изменить исключение контекста .gitignore
По умолчанию файл .gitignore включен для исключения контекста. Он должен находиться в корневой рабочей папке Gemini Code Assist. Файлы .gitignore , расположенные в подкаталогах, не будут рассматриваться и объединяться.
Чтобы отключить файлы .gitignore из исключения контекста, выполните следующие действия:
На панели действий нажмите «Настройки» >«Управление» > «Настройки» .
В окне настроек перейдите в раздел «Расширения» > «Gemini Code Assist» . Прокрутите список, пока не найдёте «Исключение контекста Gitignore» .
Снимите флажок.
Файлы .gitignore теперь отключены для указания файлов, которые Gemini Code Assist следует игнорировать.
Напишите файл .aiexclude
Файл .aiexclude имеет следующий синтаксис:
Примеры
В следующих примерах показано, как можно настроить файл .aiexclude :
Заблокируйте все файлы с именем apikeys.txt в каталоге, содержащем файл .aiexclude , или ниже:
apikeys.txt
Заблокируйте все файлы с расширением .key в каталоге, содержащем файл .aiexclude , или ниже:
*.key
Заблокируйте только файл apikeys.txt в том же каталоге, что и файл .aiexclude , но не любые подкаталоги:
/apikeys.txt
Заблокируйте все файлы в каталоге my/sensitive/dir и всех подкаталогах. Путь должен быть указан относительно каталога, содержащего файл .aiexclude .
my/sensitive/dir/
Блокирует все файлы в каталоге foo и его подкаталогах, за исключением файла с именем bar.txt в каталоге foo.
foo/*
!foo/bar.txt
Управление доступом к индексу для настройки кода
По умолчанию настройка кода индексирует все поддерживаемые файлы кода в указанных вами репозиториях.
Чтобы предотвратить раскрытие кода, который вы не хотите использовать в контексте, вы можете использовать шаблоны ветвления для управления доступом к вашему индексу и использовать стабильную ветку, например main .
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-30 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)."]]
