github/gitignore · Angular.gitignore
شرح قالب .gitignore لـ Angular
يشرح سبب تجاهل Angular.gitignore لـ dist وذاكرة .angular وout-tsc وcoverage، ومتى يجب حذف القواعد التي تتجاهل ملفات القفل (package-lock.json وyarn.lock).
يحجب Angular.gitignore نتائج البناء والذاكرات المؤقتة في مشاريع Angular CLI. تبدأ معظم قواعده بـ / فلا تنطبق إلا على جذر مساحة العمل.
ما يستدعي الانتباه أنه يتجاهل /package-lock.json و/yarn.lock. توصي npm بوضع ملف القفل تحت إدارة الشيفرة المصدرية، لذا الشائع في التطبيقات حذف هذين السطرين.
شرح القواعد
| النمط | ما الذي يتجاهله ولماذا |
|---|---|
/dist//out-tsc//tmp/ | نتائج البناءنتائج ng build، والمخرجات الوسيطة لترجمة TypeScript، والمجلد المؤقت. |
/.angular/.angular/ | ذاكرة Angular CLIذاكرة على القرص يستخدمها Angular CLI لتسريع البناء. تجتمع قاعدة مثبّتة في الجذر مع قاعدة تطابق أي عمق لتحجب ذاكرات المشاريع الفرعية أيضًا. |
/coverage//e2e/test-output/ | نتائج الاختباراتتغطية Karma وJest ونتائج اختبارات E2E. |
/node_modules//package-lock.json/yarn.lock | الاعتماديات وملفات القفلاستبعاد node_modules أمر بديهي، لكن استبعاد ملفات القفل أيضًا قد يجعل إصدارات الاعتماديات تختلف مع كل تثبيت. |
/.env/.angular-cli.json/.ng/ | البيئة والإعداداتملف متغيرات البيئة، وملف ومجلد إعدادات Angular CLI القديمة. |
*.tsbuildinfonpm-debug.log*yarn-debug.log*yarn-error.log* | السجلات ومعلومات البناءمعلومات البناء التزايدي في TypeScript وسجلات مدير الحزم. |
ملاحظات عملية
- بعد اختيار Angular في المولّد، إذا أضفت
!/package-lock.jsonإلى القواعد التي تضيفها بنفسك استعدت ملف القفل دون تعديل نص القالب الأصلي. - لا تضع في
src/environments/environment.tsإلا القيم التي لا ضرر من كشفها، فهذا الملف يُضمَّن في نتائج البناء ويصل إلى المتصفح. - لإعدادات المحررات استخدم معه قالبي VisualStudioCode وJetBrains.
القالب الأصلي
Angular.gitignore
# Angular specific/dist//out-tsc//tmp//coverage//e2e/test-output//.angular/.angular/# Node modules and dependency files/node_modules//package-lock.json/yarn.lock# Environment files/.env# Angular CLI and build artefacts/.angular-cli.json/.ng/# TypeScript cache*.tsbuildinfo# Logsnpm-debug.log*yarn-debug.log*yarn-error.log*
مصدر القوالب: github/gitignore/Angular.gitignore @356fd7b (2026-09-11) · CC0-1.0