Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Gemini Code Assist obsługuje wykluczanie plików z kontekstu na potrzeby generowania, uzupełniania i przekształcania kodu oraz czatu. W przypadku użytkowników wersji Enterprise obejmuje to również dostosowywanie kodu.
W wielu przypadkach będziesz mieć konkretne pliki lub poddrzewa, których nie chcesz uwzględniać w kontekście.
Możesz wykluczyć te pliki, używając pliku .aiexclude lub .gitignore.
Konfigurowanie ustawień wykluczeń kontekstowych
W tej sekcji dowiesz się, jak skonfigurować ustawienia plików .aiexclude i .gitignore.
Zmień plik .aiexclude na preferowany plik
Domyślnie wykluczenie kontekstowe jest ustawione na .aiexclude. Aby zmienić to ustawienie w IDE, wykonaj te czynności:
VS Code
Na pasku aktywności kliknij ustawieniaZarządzaj > Ustawienia.
W oknie Ustawienia kliknij Rozszerzenia > Gemini Code Assist. Przewiń w dół, aż zobaczysz Plik wykluczeń kontekstowych.
W polu tekstowym zmień .aiexclude na preferowaną lokalizację.
Wybrany plik jest teraz ustawiony jako plik wykluczeń kontekstowych.
IntelliJ
Konfigurowanie ustawień plików .aiexclude i .gitignore nie jest obsługiwane w środowiskach IDE JetBrains.
Zmiana wykluczenia kontekstu w pliku .gitignore
Domyślnie plik .gitignore jest włączony w przypadku wykluczenia kontekstowego. Plik musi znajdować się w głównym folderze roboczym Gemini Code Assist. .gitignore pliki znajdujące się w podkatalogach nie będą brane pod uwagę ani scalane.
Aby wyłączyć wykluczanie z kontekstu plików .gitignore, wykonaj te czynności:
Na pasku aktywności kliknij ustawieniaZarządzaj > Ustawienia.
W oknie Ustawienia kliknij Rozszerzenia > Gemini Code Assist. Przewiń w dół, aż znajdziesz Context Exclusion Gitignore (Wykluczenie kontekstu Gitignore).
Odznacz pole wyboru.
Pliki .gitignore są teraz wyłączone w przypadku określania plików, które Gemini Code Assist ma ignorować.
Zapisywanie pliku .aiexclude
Plik .aiexclude ma taką samą składnię jak plik .gitignore.
Przykłady
Poniższe przykłady pokazują, jak skonfigurować plik .aiexclude:
Zablokuj wszystkie pliki o nazwie apikeys.txt w katalogu zawierającym plik .aiexclude lub w jego podkatalogach:
apikeys.txt
Zablokuj wszystkie pliki z rozszerzeniem .key w katalogu zawierającym plik .aiexclude lub w jego podkatalogach:
*.key
Zablokuj tylko plik apikeys.txt w tym samym katalogu co plik .aiexclude, ale nie podkatalogi:
/apikeys.txt
Blokuj wszystkie pliki w katalogu my/sensitive/dir i we wszystkich podkatalogach.
Ścieżka powinna być względna w stosunku do katalogu zawierającego plik .aiexclude.
my/sensitive/dir/
Blokuje wszystkie pliki w katalogu foo i jego podkatalogach z wyjątkiem pliku o nazwie bar.txt w katalogu foo.
foo/*
!foo/bar.txt
Kontrolowanie dostępu do indeksu na potrzeby dostosowywania kodu
Domyślnie dostosowywanie kodu indeksuje wszystkie obsługiwane pliki z kodem w określonych repozytoriach.
Aby zapobiec ujawnieniu kodu, którego nie chcesz używać w danym kontekście, możesz użyć wzorców gałęzi, aby kontrolować dostęp do indeksu, i użyć stabilnej gałęzi, np. main.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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)."]]
