تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتيح لك Gemini Code Assist استبعاد ملفات من سياقك عند إنشاء الرموز البرمجية وإكمالها وتحويلها والدردشة. بالنسبة إلى مستخدمي Enterprise، يشمل ذلك أيضًا تخصيص الرمز.
في العديد من السيناريوهات، ستتضمّن سياقك ملفات أو أشجار فرعية معيّنة لا تريد تضمينها.
يمكنك استبعاد هذه الملفات باستخدام ملف .aiexclude أو .gitignore.
ضبط إعدادات استثناءات السياق
يوضّح لك هذا القسم كيفية ضبط إعدادات ملفات .aiexclude و.gitignore.
تغيير ملف .aiexclude إلى الملف المفضّل لديك
يتم تلقائيًا ضبط استبعاد السياق على استخدام .aiexclude. لتغيير هذا الإعداد في بيئة التطوير المتكاملة، اتّبِع الخطوات التالية:
VS Code
في شريط الأنشطة، انقر على
الإعداداتإدارة >
الإعدادات.
في نافذة الإعدادات، انتقِل إلى الإضافات > Gemini Code Assist. انتقِل للأسفل إلى أن يظهر لك ملف استبعاد السياق.
في حقل النص، غيِّر .aiexclude إلى الموقع الجغرافي المفضّل.
تم الآن ضبط الملف المفضّل لديك كملف استثناء السياق.
IntelliJ
لا تتوافق ملفات .aiexclude و.gitignore مع بيئات التطوير المتكاملة من JetBrains.
تغيير استبعاد سياق ملف .gitignore
يكون ملف .gitignore مفعَّلاً تلقائيًا لاستبعاد السياق. يجب أن يكون الملف
في مجلد العمل الجذر
في Gemini Code Assist. لن يتم أخذ ملفات .gitignore الموجودة في أدلة فرعية في الاعتبار أو دمجها.
لإيقاف .gitignore من الاستبعاد حسب السياق، اتّبِع الخطوات التالية:
في شريط الأنشطة، انقر على
الإعداداتإدارة >
الإعدادات.
في نافذة الإعدادات، انتقِل إلى الإضافات > Gemini Code Assist. انتقِل إلى أسفل الصفحة حتى يظهر لك Context Exclusion 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
التحكّم في إمكانية الوصول إلى الفهرس لتخصيص الرموز
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
