شرح قالب .gitignore لـ Next.js

تكوين Nextjs.gitignore يكاد يطابق ملف .gitignore الذي ينشئه create-next-app. تبدأ معظم قواعده بـ / فهي مثبّتة في جذر المستودع، لذا إن كان التطبيق في مجلد فرعي داخل مستودع أحادي فعدّل المسارات أو استخدم معه قالب Node.

يقرأ Next.js ملفات بيئة متعددة مثل .env و.env.local و.env.development.local. ويستبعد هذا القالب .env و.env*.local كليهما.

شرح القواعد

النمط	ما الذي يتجاهله ولماذا
/.next//out//build	بناء Next.jsنتائج next build وذاكرتها (.next)، ونتائج التصدير الساكن (out). يُعاد إنشاؤها أثناء النشر.
/node_modules/.pnp.pnp.js	الاعتمادياتنتائج تثبيت الحزم وملفات Yarn Plug'n'Play. ولأنها مثبّتة في الجذر فقط فإنها لا تحجب node_modules في الحزم الفرعية.
.env.env*.local	متغيرات البيئةملفات بيئة تحوي قيمًا سرية. المتغيرات التي تبدأ بـ NEXT_PUBLIC_ تُضمَّن في نتائج البناء فتنكشف للمتصفح، لذا تُستخدم الأسرار بلا هذه البادئة وعلى الخادم فقط.
.vercelnext-env.d.ts*.tsbuildinfo	ملفات النشر والأنواع المولَّدةمعلومات ربط المشروع التي ينشئها vercel link، وملف تعريفات الأنواع الذي يعيد Next.js إنشاءه أثناء التطوير والبناء، ومعلومات البناء التزايدي في TypeScript.
*.pem	الشهاداتملفات الشهادات والمفاتيح الخاصة (.pem) المستخدمة في تطوير HTTPS محليًا أو في الربط مع خدمات خارجية. لا تُودَع المفاتيح الخاصة.
npm-debug.log*yarn-debug.log*yarn-error.log*/coverage.DS_Store	السجلات وغيرهاسجلات مدير الحزم، وتغطية الاختبارات، وملف Finder في macOS.

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

• في المستودع الأحادي (apps/web) لا تنطبق القواعد المثبّتة في الجذر مثل /node_modules على التطبيقات الفرعية. إذا اخترت معه قالب Node طابقت node_modules/ على أي عمق.
• أودِع ملفات الإعداد وملف القفل مثل next.config.js وpackage-lock.json.
• بدل إيداع .env شارك أسماء المتغيرات اللازمة عبر README أو .env.example.

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

# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.# dependencies/node_modules/.pnp.pnp.js# testing/coverage# next.js/.next//out/# production/build# misc.DS_Store*.pem# debugnpm-debug.log*yarn-debug.log*yarn-error.log*# local env files.env*.local.env# vercel.vercel# typescript*.tsbuildinfonext-env.d.ts

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

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