Loại trừ các tệp khỏi việc sử dụng tính năng Gemini Code Assist
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tính năng Trợ giúp mã của Gemini hỗ trợ việc loại trừ các tệp khỏi ngữ cảnh của bạn để tạo mã, hoàn thành mã, chuyển đổi mã và trò chuyện. Đối với người dùng Enterprise, tính năng này cũng bao gồm tuỳ chỉnh mã.
Trong nhiều trường hợp, bạn sẽ có các tệp hoặc cây con cụ thể mà bạn không muốn đưa vào ngữ cảnh.
Bạn có thể loại trừ các tệp này bằng cách sử dụng tệp .aiexclude hoặc .gitignore.
Ghi tệp .aiexclude
Tệp .aiexclude tuân theo cú pháp sau:
Ví dụ
Các ví dụ sau đây minh hoạ cách bạn có thể định cấu hình tệp .aiexclude:
Chặn tất cả tệp có tên apikeys.txt ở hoặc dưới thư mục chứa tệp .aiexclude:
apikeys.txt
Chặn tất cả tệp có đuôi tệp .key ở hoặc dưới thư mục chứa tệp .aiexclude:
*.key
Chỉ chặn tệp apikeys.txt ở cùng thư mục với tệp .aiexclude, nhưng không chặn bất kỳ thư mục con nào:
/apikeys.txt
Chặn tất cả tệp trong thư mục my/sensitive/dir và tất cả thư mục con.
Đường dẫn phải tương ứng với thư mục chứa tệp .aiexclude.
my/sensitive/dir/
Chặn tất cả tệp trong thư mục foo và các thư mục con của thư mục đó, ngoại trừ tệp có tên bar.txt trong thư mục foo.
foo/*
!foo/bar.txt
Kiểm soát quyền truy cập vào chỉ mục để tuỳ chỉnh mã
Theo mặc định, tính năng tuỳ chỉnh mã sẽ lập chỉ mục tất cả tệp mã được hỗ trợ trong các kho lưu trữ bạn chỉ định.
Để ngăn việc hiển thị mã mà bạn không muốn sử dụng trong ngữ cảnh, bạn có thể sử dụng mẫu nhánh để kiểm soát quyền truy cập vào chỉ mục và sử dụng một nhánh ổn định, chẳng hạn như main.
Ngoài ra, bạn cũng có thể loại trừ các tệp khỏi ngữ cảnh bằng cách
tạo tệp .aiexclude.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Khó hiểu","hardToUnderstand","thumb-down"],["Thông tin hoặc mã mẫu không chính xác","incorrectInformationOrSampleCode","thumb-down"],["Thiếu thông tin/mẫu tôi cần","missingTheInformationSamplesINeed","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-06-11 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)."]]
