فهم ملف .gitignore
تعلّم كيف يمنع .gitignore الملفات غير المرغوب فيها من الوصول إلى مستودعك، باستخدام الأنماط وقواعد النطاق وتجنّب الأخطاء الشائعة.
فهم ملف .gitignore درس مجاني في Git & GitHub Professional Workflow على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Git & GitHub Professional Workflow، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Git & GitHub Professional Workflow 4 دروس في المجموع.
ليس كل شيء ينتمي إلى Git
يجب عدم إيداع نواتج البناء والسجلات والأسرار ومجلدات التبعيات مطلقًا. ويخبر ملف .gitignore Git بالملفات التي يجب تخطيها بدقة.
ما هو .gitignore؟
ملف .gitignore هو مجرد ملف نصي مليء بالأنماط. ويُستبعد أي مسار يطابق نمطًا من منطقة التجهيز والإيداعات، مما يحافظ على نظافة مستودعك.
إنشاء أول ملف .gitignore لك
ضع ملف .gitignore في جذر المستودع، مع نمط واحد في كل سطر. يتجاهل المثال أدناه التبعيات والسجلات وملف env الخاص بك.
# .gitignore
node_modules/
*.log
.envقواعد الأنماط الأساسية
الأنماط الأساسية: يطابق *.log حسب الامتداد، ويطابق build/ دليلًا كاملًا، بينما يطابق الاسم المجرّد ملفًا واحدًا محددًا.
*.tmp
dist/
config.local.jsonالتثبيت باستخدام شرطة مائلة في البداية
تثبّت الشرطة المائلة في البداية النمطَ بجذر المستودع، لذلك يتجاهل /todo.txt الملف الموجود في المستوى الأعلى فقط، وليس ملفًا بالاسم نفسه في مستوى أعمق من الشجرة.
# only ignores /todo.txt at the root
/todo.txt
# ignores todo.txt anywhere
todo.txtالنفي باستخدام علامة التعجب
أضف ! إلى بداية النمط لإلغاء تجاهل شيء استبعدته قاعدة سابقة، مثل تجاهل جميع السجلات باستثناء سجل واحد تريد الاحتفاظ به.
# ignore all logs except the important one
*.log
!important.logأحرف البدل: النجمة والنجمتان
بالنسبة إلى أحرف البدل: تطابق * أي شيء باستثناء الشرطة المائلة، بينما تطابق ** عبر الأدلة مهما كان عمقها.
# any file in any logs directory at any depth
**/logs/*.log
# any .cache file in this dir or below
**/*.cacheالتعليقات والأسطر الفارغة
الأسطر التي تبدأ بـ # هي تعليقات، بينما يتم تخطي الأسطر الفارغة. استخدم كليهما للحفاظ على تنظيم ملف .gitignore وسهولة قراءته.
# Dependencies
node_modules/
# Environment
.envمشكلة الملفات المتتبعة مسبقًا
تنبيه مهم: لا يؤثر .gitignore إلا في الملفات غير المتتبعة. إذا كان الملف متتبعًا بالفعل، فلن تفعل القاعدة شيئًا حتى تلغي تتبعه باستخدام git rm --cached.
git rm --cached secret.txt
# now the ignore rule takes effect for future commitsالتحقق من سبب تجاهل ملف
ألست متأكدًا من سبب تجاهل مسار ما؟ يخبرك git check-ignore -v بالقاعدة والسطر اللذين طابقاه تحديدًا.
git check-ignore -v build/app.js
# .gitignore:2:build/ build/app.jsالتجاهل العام
بالنسبة إلى الفوضى الشخصية، مثل إعدادات المحرر ومخلفات نظام التشغيل، التي يجب ألا تصل إلى أي مستودع، اضبط تجاهلًا عامًا بدلًا من تلويث ملفات المشروع.
git config --global core.excludesFile ~/.gitignore_globalتحقق سريع
اختبر معرفتك بملف .gitignore.
مراجعة
أتقنت استخدام .gitignore: الأنماط وأحرف البدل (* و**) والتثبيت (/) والنفي (!). تذكّر أنه لا يؤثر إلا في الملفات غير المتتبعة، واستعن بـ git check-ignore لتصحيح المشكلات.
الأسئلة الشائعة
هل درس «فهم ملف .gitignore» مجاني؟
نعم — نص درس «فهم ملف .gitignore» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Git & GitHub Professional Workflow، انتقل إلى CoddyKit PRO. تتضمن دورة Git & GitHub Professional Workflow 4 دروس في المجموع.
ماذا ستتعلم في «فهم ملف .gitignore»؟
تعلّم كيف يمنع .gitignore الملفات غير المرغوب فيها من الوصول إلى مستودعك، باستخدام الأنماط وقواعد النطاق وتجنّب الأخطاء الشائعة. تتمرن على Git & GitHub Professional Workflow مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Git & GitHub Professional Workflow؟
لا تُشترط خبرة سابقة. Git & GitHub Professional Workflow على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «فهم ملف .gitignore»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Git & GitHub Professional Workflow هذا؟
نعم. كل درس في Git & GitHub Professional Workflow يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- مقدمة إلى التحكم في الإصدارات
- تثبيت Git وإعداده
- إنشاء مستودعك الأول
- فهم ملف .gitignore