شرح قالب .gitignore لـ VS Code

VisualStudioCode.gitignore قالب نموذجي لأنماط النفي. فهو يستبعد كل محتوى مجلد .vscode/ ثم يعيد عبر ! تضمين ملفات الإعدادات التي تستحق المشاركة مع الفريق فقط.

النقطة الجوهرية هنا أنه كُتب .vscode/* لا .vscode/. فإذا استُبعد المجلد نفسه لم ينظر git داخله، ولم يكن لقواعد ! اللاحقة أي أثر.

شرح القواعد

النمط	ما الذي يتجاهله ولماذا
.vscode/*	استبعاد محتوى المجلديستبعد مبدئيًا كل الملفات داخل .vscode، بما فيها الذاكرات والإعدادات الشخصية التي تنشئها الإضافات. ولأن المجلد نفسه لا يُستبعد، يمكن إعادة الملفات الفرعية.
!.vscode/settings.json!.vscode/tasks.json!.vscode/launch.json	إعدادات مساحة العمل المشتركةإعدادات أدوات التنسيق والفحص، ومهام البناء، وتهيئات التصحيح تساعد الفريق على التطوير بالطريقة نفسها.
!.vscode/extensions.json!.vscode/*.code-snippets	الإضافات الموصى بها والمقتطفاتextensions.json قائمة الإضافات التي يُقترح تثبيتها عند فتح المشروع، و.code-snippets مقتطفات شيفرة خاصة بالمشروع.
!*.code-workspace	مساحة العمل متعددة الجذوريعيد تضمين ملفات مساحة العمل التي تجمع عدة مجلدات، حتى لو تجاهلها قالب آخر.
*.vsix	حزم الإضافات المبنيةحزم التثبيت التي ينشئها vsce package عند تطوير إضافات VS Code.

ملاحظات عملية

• لا تضع تفضيلاتك الشخصية (حجم الخط، السمة) في settings.json، بل في إعدادات المستخدم. فإعدادات المستودع تنطبق على الفريق بأكمله.
• إن وضعت مسارات شخصية أو رموزًا في launch.json فاستبدلها قبل الإيداع بمتغيرات مثل ${workspaceFolder}.
• إن أردت إخفاء .vscode/ بالكامل فضع سطرًا واحدًا .vscode/ في ملف gitignore العام بدل هذا القالب. لكنك ستتخلى بذلك عن مشاركة إعدادات الفريق.

القالب الأصلي

# Visual Studio Code.vscode/*!.vscode/settings.json!.vscode/tasks.json!.vscode/launch.json!.vscode/extensions.json!.vscode/*.code-snippets!*.code-workspace# Built Visual Studio Code Extensions*.vsix

قوالب تُستخدم معه

شروح قوالب أخرى