أداتان صغيرتان تُبقيان الـ working tree تحت السيطرة. git stash يعطيك درجًا للعمل غير الجاهز للـ commit. و .gitignore يخبر Git بالملفات التي يجب ألّا يتتبّعها أبدًا. وكلتاهما تمنعان النوع نفسه من الحوادث: أن يتسلّل الشيء الخطأ إلى commit.
أنت في منتصف نموذج التواصل في الموقع الشخصي على فرع contact-form، حين ينبّهك أحدهم إلى خطأ إملائي في الصفحة الرئيسية المنشورة. تحتاج إلى main، الآن. لكن git switch main يرفض، لأن تعديلاتك على index.html ستُكتب فوقها، ولا تريد تسجيل نموذج نصف مبني في commit.
خبّئه (stash):
\ngit stash push -m \"contact form: fields done, validation next\"\ngit status # nothing to commit, working tree cleanتغييراتك، المجهّزة وغير المجهّزة، تُحفظ في مدخل stash وتُزال من الـ working tree. الآن أصلح الخطأ الإملائي:
\ngit switch main\n# fix, commit, push\ngit switch contact-form\ngit stash popالـ pop يعيد تطبيق أحدث stash ويحذفه. وتعود تمامًا إلى حيث كنت.
أوامر الـ stash الأخرى التي ستستخدمها:
\ngit stash list # stash@{0}: On contact-form: contact form: fields done…\ngit stash show -p stash@{0} # the diff inside a stash\ngit stash apply stash@{1} # reapply but keep the stash\ngit stash drop stash@{1} # delete one stash\ngit stash push -u -m \"…\" # include untracked (new) files tooالخيار الأخير مهم. افتراضيًا لا يحفظ الـ stash إلا التغييرات على الملفات المتتبَّعة. أما contact.js الجديد كليًا فيبقى في مجلدك دون أن يُمسّ، وهذا يفاجئ الناس حين ينفّذون pop ولا «يُستعاد». استخدم -u كلما أنشأت ملفات.
الـ stash غير مربوط بفرع: تستطيع تنفيذ pop له على أي فرع، وهذا مفيد أحيانًا ومفاجئ أحيانًا. وإن أدركت أن العمل المخبّأ يستحق فرعًا خاصًا به في النهاية، فإن git stash branch contact-validation ينشئ فرعًا عند الـ commit الذي خبّأت عنده، ويطبّق الـ stash هناك ثم يحذفه، فيتجنّب التعارضات مع أي شيء تغيّر منذ ذلك الحين.
إن اصطدم الـ pop بتعارض، يطبّق Git ما يستطيعه، ويعلّم التعارض كالمعتاد، ويحتفظ بالـ stash بدل حذفه. حُلّ التعارض، ونفّذ git add، وشغّل git stash drop حين تتأكّد.
بعض الملفات مكانها في مجلد مشروعك، لكن ليس في السجلّ أبدًا:
\nnode_modules/؛dist/؛.env؛.DS_Store على macOS.اسردها في ملف اسمه .gitignore في جذر الـ repository وسجّله في commit، ليتشارك كل من في المشروع القواعد نفسها:
# Dependencies\nnode_modules/\n\n# Build output\n/dist/\n\n# Local environment and secrets\n.env\n.env.*\n!.env.example\n\n# OS and editor files\n.DS_Store\n*.logالملفات المتجاهَلة تختفي من git status، ويتخطّاها git add ..
كل سطر نمط (pattern)، يُطابق مع المسارات نسبةً إلى مجلد ملف .gitignore:
# تبدأ تعليقًا، لكن فقط في بداية السطر. والأسطر الفارغة تُتجاهل.*.log يطابق أي ملف ينتهي بـ .log، في أي مجلد./ في النهاية تطابق المجلدات فقط: node_modules/./ في البداية تثبّت النمط على هذا المجلد: /dist/ يتجاهل dist في الجذر لكن لا يتجاهل src/dist.**/ يطابق أي عمق: **/fixtures/*.json.! تعيد تضمين شيء استبعده سطر سابق: !.env.example يُبقي القالب للمطوّرين الآخرين. لكنها لا تستطيع إعادة تضمين ملف استُبعد المجلد الأب الخاص به، لأن Git لا ينظر أبدًا داخل مجلد متجاهَل.حين يكون ملف ما متجاهَلًا ولا تعرف السبب، اسأل Git:
\ngit check-ignore -v dist/app.js.gitignore:5:/dist/\tdist/app.jsيطبع الملف ورقم السطر والنمط المسؤول.
\nوللفوضى التي لا يُنشئها إلا جهازك، لا تُثقل ملف .gitignore في كل مشروع. فـ Git يقرأ أيضًا ملف تجاهل عامًا، ~/.config/git/ignore، وهو مكان مناسب لـ .DS_Store ومجلدات المحرّر. ويحتفظ GitHub بمجموعة من قوالب .gitignore الجاهزة لمعظم اللغات، ويعرض عليك واحدًا حين تنشئ repository.
.gitignore لا يؤثّر إلا في الملفات غير المتتبَّعة. إن كان .env قد سُجّل في commit قبل أن تتجاهله، فسيواصل Git تتبّعه. أزله من الـ index وأنشئ commit، وهذا يُبقي ملفك المحلي:
git rm --cached .env\ngit commit -m \"Stop tracking .env\"صار الـ working tree نظيفًا، ولا يحتوي الـ repository إلا ما يجب أن يحتويه. في الدرس التالي ستجعل ما يحتويه مقروءًا: رسائل الـ commits، والـ tags، والإصدارات.
\n","toc":[{"id":"sec-1","text":"الـ Stash: درج للعمل غير المكتمل","level":2},{"id":"sec-2","text":"ملف .gitignore: ملفات يجب ألّا يتتبّعها Git أبدًا","level":2},{"id":"sec-3","text":"كيف تعمل الأنماط","level":2},{"id":"sec-4","text":"التجاهل لا يلغي التتبّع","level":2}],"takeaways":["git stash push -m "…" يحفظ تغييراتك غير المسجّلة ويُنظّف الـ working tree؛ و git stash pop يعيدها ويحذف الـ stash.","git stash يتخطّى الملفات غير المتتبَّعة ما لم تضف -u (--include-untracked).",".gitignore لا يؤثّر إلا في الملفات غير المتتبَّعة؛ ولإيقاف تتبّع ملف مسجّل، شغّل git rm --cached وأنشئ commit.","في .gitignore، الشرطة المائلة / في النهاية تطابق المجلدات فقط، وفي البداية تثبّت النمط على ذلك المجلد، و ! تعيد تضمين ملف.","السرّ الذي سُجّل في commit ورُفع ولو مرة يجب إلغاؤه واستبداله، لأن السجلّ ما زال يحتويه."],"further":[{"title":"git stash reference","url":"https://git-scm.com/docs/git-stash"},{"title":"gitignore pattern format","url":"https://git-scm.com/docs/gitignore"},{"title":"Ignoring files (GitHub Docs)","url":"https://docs.github.com/en/get-started/git-basics/ignoring-files"}],"quiz":[{"q":"أنت في منتصف نموذج التواصل حين يلزم إصلاح خطأ إملائي عاجل على main. يرفض git switch main لأنه سيكتب فوق تغييراتك. ما أسرع طريق نظيف؟
git restore .، وأصلح الخطأ، وأعِد بناء النموذج لاحقًا.","why":"هذا يرمي عملًا حقيقيًا لتوفير بضع ثوانٍ. أما الـ stash فيحفظه بأمان."},{"text":"git stash push -m "contact form wip"، ثم انتقل إلى main، وأصلح وسجّل، ثم عُد، ثم git stash pop.","why":"صحيح. يحتفظ الـ stash بعملك غير المكتمل بينما يكون الـ working tree نظيفًا، والـ pop يعيده إلى حيث توقّفت."},{"text":"افرض الانتقال بـ git switch -f main.","why":"-f يرمي تغييراتك المحلية ليُتمّ الانتقال، وهذا بالضبط ما أردت تجنّبه."},{"text":"سجّل النموذج غير المكتمل في commit على main برسالة “WIP”.","why":"ستضع عملًا معطّلًا على main. إن أردت commit من نوع WIP، فأنشئه على فرع الـ feature الخاص بك."}],"answer":1},{"q":"نفّذت stash، وانتقلت بين الفروع، ثم عدت. أعاد git stash pop تعديلاتك على contact.html لكن ملفك الجديد contact.js مفقود. لماذا؟
git stash pop يستعيد الملفات بترتيب تعديلها وقد توقّف مبكرًا.","why":"الـ pop يستعيد كل ما في الـ stash دفعة واحدة. والملف لم يكن في الـ stash أصلًا."},{"text":"حُذف الملف بسبب الانتقال بين الفروع.","why":"الانتقال لا يمسّ الملفات غير المتتبَّعة. الـ stash هو الذي تخطّاه، ولهذا قد يكون ما زال في مجلدك."},{"text":"تنتهي صلاحية الـ stash بعد انتقال واحد بين الفروع.","why":"يبقى الـ stash حتى تحذفه أو تنفّذ pop له. و git stash list يعرضه."},{"text":"git stash لا يتضمّن الملفات غير المتتبَّعة ما لم تمرّر -u، فبقي contact.js في الـ working tree.","why":"صحيح. الملفات غير المتتبَّعة لا تُخبّأ افتراضيًا. تفقّد الـ working tree، فالأرجح أنه هناك، واستخدم git stash -u في المرة القادمة."}],"answer":3},{"q":"سجّلت .env في commit الأسبوع الماضي. واليوم تضيف .env إلى .gitignore، لكن git status ما زال يعرض .env على أنه معدّل. لماذا؟
.gitignore لا ينطبق إلا على الملفات غير المتتبَّعة، و .env متتبَّع بالفعل؛ شغّل git rm --cached .env وأنشئ commit.","why":"صحيح. --cached يزيله من الـ index (فلا تتضمّنه الـ commits القادمة) ويترك الملف على القرص."},{"text":"يجب أن يكون النمط /.env/ لكي يعمل.","why":"الشرطة المائلة في النهاية تجعل النمط يطابق المجلدات فقط، فلن يطابق /.env/ الملف أصلًا."},{"text":"تغييرات .gitignore لا تسري إلا بعد الرفع.","why":"قواعد التجاهل تسري فورًا، محليًا. المشكلة أن الملفات المتتبَّعة لا تُتجاهل أبدًا."}],"answer":0},{"q":"أيّ سطر في .gitignore يتجاهل مجلد dist في جذر المشروع دون مجلد src/dist/؟
dist","why":"دون شرطة مائلة في البداية أو الوسط، يطابق النمط dist على أي عمق، بما في ذلك src/dist."},{"text":"**/dist/","why":"**/ تعني على أي عمق، فهذا يطابق src/dist/ أيضًا."},{"text":"/dist/","why":"صحيح. الشرطة المائلة في البداية تثبّت النمط على المجلد الذي يحتوي .gitignore، والشرطة في النهاية تحصره في المجلدات."},{"text":"!dist","why":"! تعيد تضمين مسار سبق تجاهله؛ ووحدها لا تتجاهل شيئًا."}],"answer":2}],"exercise":{"kind":"spot-bug","language":"text","code":"# Dependencies\nnode_modules/\n\n# Build output from the Sass experiment\n*.css\n\n# Local environment (never commit secrets)\n.env\nsecrets.json # API keys\n!.env.example\n\n# OS and editor files\n/.DS_Store\n.vscode/\n*.log","bugLines":[5,9,13],"title":"أصلح ملف .gitignore في الموقع الشخصي","prompt":"يقع ملف .gitignore هذا في جذر repository الموقع الشخصي، الذي يحتوي index.html و styles.css و projects.html، وملف .env فيه مفتاح API، و secrets.json، وملفات .DS_Store الخاصة بـ macOS في عدة مجلدات. ثلاثة أسطر لا تفعل ما قصده كاتبها. حدّدها.
.gitignore لا تعمل إلا في موضع واحد من السطر.","ملفات .DS_Store تظهر في كل مجلد فتحه macOS، لا في الجذر فقط."],"explanation":"السطر 5، *.css، يتجاهل كل ملف CSS، بما في ذلك styles.css الذي كتبته بيدك؛ تجاهل مجلد ناتج البناء الحقيقي وحده بدلًا من ذلك (مثلًا /dist/). والسطر 9 فيه تعليق في نهايته، لكن # لا تبدأ تعليقًا إلا في بداية السطر، فيصبح النمط هو النص الحرفي secrets.json # API keys ولا يُتجاهل secrets.json؛ انقل التعليق إلى سطر مستقل. والسطر 13، /.DS_Store، مثبَّت على الجذر، فتظل ملفات .DS_Store في المجلدات الفرعية تظهر؛ احذف الشرطة المائلة في بدايته (.DS_Store)، أو الأفضل أن تضعه في ملف التجاهل العام. أما السطر !.env.example فسليم: إنه يُبقي ملف القالب الذي يحتاجه المطوّرون الآخرون.