قضيت أمسية كاملة على موقعك الشخصي. أضفت شريط تنقّل إلى index.html، وأنشأت styles.css، وصحّحت خطأً إملائيًا في اسمك أثناء ذلك. هذه ثلاثة تغييرات لا علاقة لبعضها ببعض. لو سجّلتها معًا في commit واحد باسم “updates”، فلن تستطيع لاحقًا التراجع عن شريط التنقّل دون التراجع عن تصحيح الخطأ الإملائي أيضًا. يعطيك Git مكانًا ترتّب فيه التغييرات قبل أن تصبح جزءًا من السجلّ.
كل تغيير في مشروع Git يعيش في واحد من ثلاثة أماكن:
\ngit add ينسخ المحتوى الحالي للملف إليه..git. والأمر git commit يحوّل الـ index إلى commit جديد.بعد الـ commit لا يُفرَّغ الـ index. بل يظل يحمل اللقطة الكاملة التي سجّلتها للتو، فيطابق آخر commit إلى أن تجهّز شيئًا جديدًا. لهذا فإن «التغييرات المجهّزة» تعني الفرق بين الـ index وآخر commit.
\nهذا عمل الأمسية كما يعرضه git status:
On branch main\nChanges not staged for commit:\n (use "git add <file>..." to update what will be committed)\n (use "git restore <file>..." to discard changes in working directory)\n\tmodified: index.html\n\nUntracked files:\n (use "git add <file>..." to include in what will be committed)\n\tstyles.css\n\nno changes added to commit (use "git add" and/or "git commit -a")يخبرك git status أيّ الملفات تختلف. ولرؤية الأسطر نفسها استخدم git diff، وتذكّر أن هناك مقارنتين:
git diff # working tree vs index: what you haven't staged yet\ngit diff --staged # index vs last commit: what the next commit will containالخيار --cached مرادف أقدم لـ --staged؛ وستراهما كليهما في الشروحات. اجعل تشغيل git diff --staged عادة قبل كل commit مباشرة. إنها اللحظة الأخيرة لتلاحظ console.log نسيته أو ملفًا لا ينتمي إلى هذا الـ commit.
تصحيح الخطأ الإملائي وشريط التنقّل كلاهما في index.html. الأمر git add index.html سيجهّزهما معًا. جهّز تصحيح الخطأ وحده بدلًا من ذلك:
git add -p index.htmlيعرض Git كل كتلة متغيّرة، وتُسمّى hunk، ويسأل Stage this hunk [y,n,q,a,d,s,e,?]? (تعرض الإصدارات الأحدث حروفًا إضافية، والحرف ? يشرحها كلها). أجب بـ y على كتلة الخطأ الإملائي و n على كتلة شريط التنقّل (والحرف s يقسم الكتلة إن كانت كبيرة جدًا). ثم:
git diff --staged # only the typo fix\ngit commit -m \"Fix spelling of name in header\"\ngit add index.html styles.css\ngit commit -m \"Add navigation bar with base styles\"اثنان من الـ commits، لكل منهما غرض واحد. ولاحقًا، إن احتجت إلى إزالة شريط التنقّل، تستطيع التراجع عن ذلك الـ commit وحده.
\nالـ commit الجيد يفعل شيئًا واحدًا تستطيع وصفه بجملة قصيرة دون كلمة «و». الرسالة “Fix spelling of name in header” تنجح في هذا الاختبار. أما “Add nav, fix typo, tweak colours” فتفشل، ويظهر الفشل لاحقًا: حين يتبيّن أن الألوان خاطئة، فإن التراجع عن ذلك الـ commit يزيل شريط التنقّل أيضًا ويعيد الخطأ الإملائي.
\nلا يوجد حدّ لعدد الأسطر. الـ commit الذي يعيد تسمية class في CSS عبر اثني عشر ملفًا يظل فكرة واحدة، وتقسيمه سيترك الموقع معطّلًا بين الخطوتين. اسعَ إلى commits يبقى المشروع بعدها وقبلها يعمل، وكل واحد منها خطوة تستطيع شرحها للمراجِع في نَفَس واحد. ستقدّر هذا في القسم الرابع، حين يصبح التراجع عن commit واحد أمرًا من سطر واحد بدل ساعات من العمل الجراحي الدقيق.
\n\nيضغط git status -s المعلومات نفسها في عمودين: الأيسر يقارن الـ index بآخر commit، والأيمن يقارن الـ working tree بالـ index.
M README.md\n M index.html\nMM styles.css\n?? projects.htmlREADME.md مجهّز؛ و index.html فيه تغييرات غير مجهّزة؛ و styles.css فيه من الاثنين؛ و projects.html غير متتبَّع (untracked).
لإخراج ملف من الـ index دون أن تخسر تعديلاتك، استخدم git restore --staged styles.css. ولرمي التعديلات غير المجهّزة والعودة إلى نسخة الـ index، استخدم git restore styles.css. الأمر الثاني هو الوحيد في هذا الدرس الذي يُتلف عملًا: التغييرات التي لم تُجهَّز ولم تُسجَّل قط لا يمكن استرجاعها.
صرت قادرًا على تسجيل السجلّ الذي تقصده بالضبط. في الدرس التالي ستقرأ هذا السجلّ، وترى لماذا يسمّيه Git رسمًا بيانيًا (graph) لا قائمة.
\n","toc":[{"id":"sec-1","text":"ثلاثة أماكن قد يكون فيها عملك","level":2},{"id":"sec-2","text":"رؤية الفرق: status و diff بنوعيه","level":2},{"id":"sec-3","text":"تقسيم ملف واحد على اثنين من الـ commits","level":2},{"id":"sec-4","text":"ما الحجم المناسب للـ commit؟","level":2},{"id":"sec-5","text":"الحالة المختصرة، والتراجع","level":2}],"takeaways":["الـ working tree هو ملفاتك، والـ index (منطقة التجهيز) هو الـ commit التالي قيد التجميع، والـ repository هو الـ commits المسجّلة بالفعل.","git diff يقارن الـ working tree بالـ index؛ و git diff --staged يقارن الـ index بآخر commit.","git add -p يجهّز جزءًا من الملف، فتتحوّل جلسة تعديل فوضوية واحدة إلى عدة commits مركّزة.","git restore --staged <file> يلغي التجهيز ويحتفظ بتعديلاتك؛ أما git restore <file> فيرمي تعديلاتك غير المجهّزة.","git commit -a يجهّز الملفات المتتبَّعة المعدّلة فقط؛ والملفات الجديدة كليًا ما زالت تحتاج git add."],"further":[{"title":"Recording Changes to the Repository (Pro Git)","url":"https://git-scm.com/book/en/v2/Git-Basics-Recording-Changes-to-the-Repository"},{"title":"git restore reference","url":"https://git-scm.com/docs/git-restore"},{"title":"git add reference","url":"https://git-scm.com/docs/git-add"}],"quiz":[{"q":"جهّزت index.html، ثم عدّلته مرة أخرى. يعرض git diff التعديل الثاني فقط. لماذا؟
git diff --staged سيعرضه."},{"text":"git diff لا يعرض إلا آخر حفظ لكل ملف.","why":"لا يتتبّع Git عمليات الحفظ. إنه يقارن حالتين كاملتين، وأيّ حالتين بالضبط يعتمد على الأمر."},{"text":"git diff يقارن الـ working tree بالـ index، والتعديل الأول موجود في الـ index أصلًا.","why":"صحيح. بعد تجهيز التعديل الأول، لا يبقى من فرق بين الملف على القرص والـ index إلا التعديل الثاني."},{"text":"يلزم تنفيذ add ثانية قبل أن يعرض git diff أي شيء.","why":"git diff يعرض التغييرات غير المجهّزة، وهذا بالضبط حال التعديل الثاني. ولو جهّزته لما عرض git diff شيئًا."}],"answer":2},{"q":"شغّلت git add styles.css لكنك تريده في الـ commit القادم لا في هذا. أيّ أمر يحتفظ بتعديلاتك ويلغي تجهيز الملف فقط؟
git restore --staged styles.css","why":"صحيح. ينسخ آخر نسخة مسجّلة إلى الـ index، فيُلغى تجهيز الملف وتبقى تعديلاتك في الـ working tree."},{"text":"git restore styles.css","why":"دون --staged يستهدف هذا الأمر الـ working tree ويستبدل ملفك بنسخة الـ index. ستضيع تعديلاتك."},{"text":"git rm styles.css","why":"هذا يجهّز حذف الملف ويزيله من القرص. وهو عكس ما تريده تمامًا."},{"text":"git commit --skip styles.css","why":"لا يوجد خيار --skip في git commit. إلغاء التجهيز يحدث في الـ index قبل الـ commit."}],"answer":0},{"q":"أنشأت projects.html وعدّلت index.html، ثم شغّلت git commit -am "Add projects page". ماذا احتوى الـ commit؟
-a تعني كل الملفات في المجلد.","why":"-a تعني كل الملفات المتتبَّعة المعدّلة. والملف الذي لم يتتبّعه Git قط لا يُضمَّن."},{"text":"لا شيء، لأن -a لا يمكن جمعها مع -m.","why":"-am تركيبة شائعة وصحيحة: جهّز تغييرات الملفات المتتبَّعة، ثم أنشئ الـ commit بهذه الرسالة."},{"text":"projects.html فقط، لأنه الملف الأحدث.","why":"عمر الملف لا يهمّ Git. ما يهمّ هو هل الملف متتبَّع أم لا."},{"text":"تغييرات index.html فقط؛ و projects.html ما زال untracked.","why":"صحيح. -a يتخطّى الملفات غير المتتبَّعة، ولهذا تصف رسالة الـ commit الآن صفحة ليست موجودة فيه."}],"answer":3},{"q":"في ناتج git status -s، ماذا يخبرك السطر MM index.html؟
UU (unmerged)، لا MM."}],"answer":1}],"exercise":{"kind":"fill","language":"bash","template":"git status\ngit add {{0}} index.html # stage only the typo-fix hunk\ngit diff {{1}} # check what the next commit contains\ngit commit -m \"Fix spelling of name in header\"\n\ngit add index.html styles.css\ngit restore {{2}} styles.css # oops: unstage it, keep the edits\ngit commit -m \"Add navigation bar\"","blanks":[{"answers":["-p","--patch"]},{"answers":["--staged","--cached"]},{"answers":["--staged","-S"]}],"title":"جهّز عن قصد","prompt":"أكمل الجلسة. تجهّز جزءًا فقط من index.html (تصحيح الخطأ الإملائي)، وتتحقّق بالضبط مما سيدخل في الـ commit، وتسجّله، ثم تجهّز عمل شريط التنقّل لكنك تُخرج styles.css من الـ index دون أن تخسر تعديلاتك.
git diff وحده يعرض التغييرات غير المجهّزة. الخيار الذي تحتاجه يقارن الـ index بآخر commit.","الأمر git restore نفسه يستطيع إما رمي التعديلات أو إلغاء التجهيز. واحد فقط من الاثنين آمن هنا."],"explanation":"git add -p يمرّ على كل hunk فتستطيع تجهيز تصحيح الخطأ الإملائي وحده. و git diff --staged (أو --cached) يعرض الـ index مقارنةً بآخر commit، وهذا هو الـ commit التالي بالضبط. و git restore --staged styles.css ينسخ النسخة المسجّلة إلى الـ index، فيُلغى تجهيز الملف وتبقى تعديلاتك في الـ working tree. ودون --staged كان git restore سيكتب فوق ملفك.