ثبّت Git وعاين هوية الإيداع بأمان

• التمييز بين غياب Git وغياب المستودع.
• التحقّق من الملف التنفيذي والإصدار بعد التثبيت.
• فهم الفرق بين نطاق الأمر وإعدادات المستودع والإعدادات العامة.
• معاينة هوية GitTree Demo وإلغاء النموذج دون حفظه.

أكمل الدرس الأول أولًا. تبدأ دون مستودع للدورة: لم يُهيَّأ شيء بعد. استخدم مجلدًا خارج المستودعات، واترك GitTree عند علامة تبويب جديدة. سننشئ المشروع في الدرس الرابع.

فُحصت أوامر الطرفية باستخدام Git 2.52.0 على macOS (/opt/homebrew/bin/git) وعلى Ubuntu 24.04 (/opt/git-2.52/bin/git). قد يختلف المسار والإصدار عندك. الحد الأدنى المثبت في مصادر GitTree هو 2.39.0، وليس ذلك توصية باستخدام إصدار قديم أو ادعاءً بأنه الأحدث. اختر حزمة مدعومة ثم تحقّق من إصدارها.

لا يتطلب Git الأصلي تسجيل الدخول. يطلب GitTree تسجيل الدخول ببريدك الإلكتروني أو بمزوّد Git، ثم تشمل الخطة المجانية كل ميزات Git المحلية وتبقى مستودعاتك على جهازك. سُجّل الفيديو قبل هذا الشرط، لذلك لا تظهر فيه نافذة تسجيل الدخول. هوية الإيداع ليست حساب GitTree ولا بيانات اعتماد المضيف ولا توقيعًا مشفّرًا. سُجّلت خطوات GitTree في الإصدار 2.0 على Ubuntu 24.04. على macOS اضغط Command حيث يستخدم Windows وLinux مفتاح Ctrl.

يحفظ الإيداع عادةً اسم مؤلف التغيير وبريده، واسم الشخص الذي أودعه وبريده. قد يختلفان عندما يطبّق شخص عمل شخص آخر. في الحالة البسيطة تُستخدم هويتك المضبوطة للدورين. كتابة اسم شخص لا تثبت أنك صاحب حسابه؛ للتوقيع والتحقّق من الهوية دروس مستقلة.

تخيّل الإعداد عنوانًا تكتبه على السجلات المقبلة، لا بطاقة دخول إلى خادم. تغيير الاسم لا يعيد تسمية الإيداعات السابقة. وقد يصبح البريد المسجّل ظاهرًا عند مشاركة التاريخ، لذا اختر عنوانًا تقبل ظهوره فيه. جميع عناوين الدورة خيالية.

بالنسبة إلى user.name وuser.email العاديين، يتقدّم إعداد المستودع على القيمة العامة. ويتجاوز -c الأصلي قيمة الإعداد لهذا الاستدعاء. لكن GitTree يحافظ عمدًا على هوية المستودع عند تمرير ملف التعريف، كما توضّح واجهته؛ لا تساوِ هذه السياسة بكتابة -c يدويًا. قد تتدخل متغيرات البيئة وملفات الإعداد المضمّنة وإعدادات مجلدات العمل المرتبطة؛ ندرس تشخيصها في الدرس 52. راجع مرجع الإعدادات وخيارات أمر Git.

حدود التغيير: قراءة المسار والإصدار ومعاينة الهوية لا تغيّر مجلد العمل أو منطقة التجهيز أو المراجع المحلية أو البعيدة. التثبيت يغيّر برامج الجهاز، وحفظ ملف التعريف أو الإعداد يكتب بيانات مستمرة؛ لذلك نلغي المعاينة.

1. تحقّق أولًا

على macOS، أو على Windows داخل Git Bash، أو على Linux:

command -v git
git --version

الناتج المرصود على جهاز التأليف، بالترتيب:

/opt/homebrew/bin/git
git version 2.52.0

ليس عليك نسخ هذا المسار؛ اقرأ نتيجة جهازك. في PowerShell استخدم Get-Command git بدل أمر المسار الأول، ثم أمر الإصدار نفسه. لم يُنفّذ فحص Windows في هذه الجولة.

2. ثبّت عند الحاجة فقط

تجاوز هذه الخطوة إذا كان Git المدعوم يعمل بالفعل. الخيارات الآتية تغيّر برامج النظام وقد تطلب موافقتك؛ لم نشغّلها أثناء تأليف الدرس.

• macOS: اختر أدوات Xcode لسطر الأوامر، أو Homebrew إن كان مثبتًا لديك. لا تحتاج إلى تشغيل الخيارين معًا. خيارات التثبيت الرسمية.

xcode-select --install

البديل، عند وجود Homebrew مسبقًا:

brew install git

• Windows: نزّل المثبّت المناسب لمعمارية الجهاز من صفحة Git for Windows الرسمية، وأكمل التثبيت ثم افتح طرفية جديدة. لا نفترض أسماء شاشات المثبّت.
• Linux: استخدم قناة الحزم المدعومة لتوزيعتك. على Debian/Ubuntu يمكن استخدام الأمرين التاليين، وعلى Fedora يُستخدم sudo dnf install git. افحص الإصدار الناتج؛ قد تتضمن توزيعة قديمة إصدارًا دون الحد المطلوب. لا تضف مستودع حزم خارجيًا دون مراجعة الثقة والصيانة. الخيارات الرسمية.

sudo apt update
sudo apt install git

تختلف رسائل التثبيت بحسب النظام والحزمة وحالتها، لذلك لا نضع ناتجًا مختلقًا. بعد التثبيت أعد فتح الطرفية وكرّر فحص المسار والإصدار، ثم أعد تشغيل GitTree عند الحاجة.

3. عاين الهوية دون حفظ

يعمل الاستعلامان خارج أي مستودع. نحمل الاسم والبريد الخياليين صراحةً مع كل أمر.

git -c user.name="GitTree Demo" -c user.email=demo@example.com config --get user.name
git -c user.name="GitTree Demo" -c user.email=demo@example.com config --get user.email

الناتج المرصود، سطر من كل أمر:

GitTree Demo
demo@example.com

غيّر بريد الأمر فقط:

git -c user.name="GitTree Demo" -c user.email=maya@example.com config --get user.email

الناتج:

maya@example.com

هذه القيمة تخص الاستدعاء الحالي. إعادة استعلام البريد الأصلي ستعيد demo@example.com لأننا نمرّره مجددًا. لم نحفظ إعدادًا ولم ننشئ إيداعًا. لا تطبع كل إعداداتك للتصوير؛ قد تتضمن عناوين شخصية أو روابط تحمل بيانات اعتماد.

عند تعذّر اكتشاف Git

إذا فشل الاكتشاف يعرض GitTree إحدى الشاشات يحتاج GitTree إلى Git (GitTree needs Git)، أو إصدار Git هذا قديم جدًا (This Git is too old)، أو تعذّر استخدام Git هذا (This Git could not be used). تعرض أماكن البحث (Looked in) المسارات التي بحث فيها عند غياب Git. ثبّت Git أو أصلحه خارج التطبيق ثم اختر التحقق مجددًا (Check again)؛ يبحث GitTree من جديد، ولا يفتح علامة التبويب الجديدة العادية إلا إذا وجد Git صالحًا. يعرض الفيديو ذلك على جهاز يُخفى فيه Git عن التطبيق وحده: شاشة غياب Git، ثم الشاشة نفسها بعد ظهور Git من جديد، ثم علامة التبويب الجديدة.

يظهر الزر تحديد موقع Git… (Locate Git…) على الشاشة نفسها، لكن إجراءه فارغ في المصدر المقروء، فلا تعتمد عليه منتقيًا يعمل؛ استخدم التحقق مجددًا بعد إصلاح التثبيت. لست بحاجة إلى إزالة Git العامل لتشاهد هذه الشاشة.

معاينة الهوية دون مستودع

1. من علامة تبويب جديدة افتح التفضيلات (Preferences)، والأمر الإنجليزي التفضيلات (Preferences) ذو المعرّف app.preferences.open. الاختصار الافتراضي Command+, على macOS وCtrl+, على Windows/Linux. تظهر صفحة التفضيلات بكامل النافذة.
2. اختر ملفات التعريف (Profiles). اقرأ تنبيه يُمرَّر مع كل أمر git (Passed to each git command): يسري على أوامر GitTree، لا على الطرفيات الخارجية. لا تحرّر أي ملف قائم ولا تبدّل إليه.
3. اختر ملف تعريف جديد (New profile). يظهر نموذج غير محفوظ.
4. في اسم ملف التعريف (Profile name) اكتب Course preview. وفي الاسم في الإيداعات (user.name) اكتب GitTree Demo، وفي البريد الإلكتروني في الإيداعات (user.email) اكتب demo@example.com.
5. اترك مفتاح التوقيع (user.signingkey) وأمر SSH (core.sshCommand) فارغين. تحت كيف تصل الهوية إلى git (How the identity reaches git) افحص يُمرَّر مع كل أمر git. لا تختر يُكتب في ~/.gitconfig (Written to ~/.gitconfig).
6. اختر إلغاء (Cancel)، لا إنشاء ملف التعريف. يغلق النموذج دون إضافة صف جديد. اختر الخروج من التفضيلات (Exit Preferences) للعودة إلى علامة التبويب الجديدة.
7. للدخول البديل افتح لوحة الأوامر… (Command Palette…) باستخدام Command+Shift+P أو Ctrl+Shift+P، وابحث عن تبديل الملف الشخصي… (Switch Profile…) في الواجهة الإنجليزية، ومقابله تبديل الملف الشخصي… (Switch Profile…) (profile.switch). يفتح صفحة ملفات التعريف ولا يختار هوية أخرى تلقائيًا. اخرج دون تبديل.

هناك نافذة مستقلة بعنوان إعداد هويتك في Git (Set up your Git identity) تظهر بعد فشل إيداع بسبب الهوية، وتتضمن حقلي الاسم والبريد وأهداف حفظ صريحة. لا نفتعل هذا الفشل هنا دون مستودع. نضبط هوية المشروع المحلية في الدرس الرابع، ونشرح ملفات التعريف المستمرة في الدرس 52.

في النهاية تعرف مسار Git وإصداره، وتفهم هوية الأمر التجريبية. لا يوجد بعد مجلد عمل للدورة أو منطقة تجهيز أو سجل فروع أو مرجع بعيد أو رسم تاريخ. لم نحفظ إعدادًا عامًا أو ملف تعريف.

• توقّع Git مرفقًا مع GitTree: مسار الإعداد المقروء يستخدم تثبيت Git الخاص بك.
• اعتبار بريد الحساب هوية إيداع تلقائية: الحساب وبيانات الإيداع أمران منفصلان.
• حفظ هوية الدورة عالميًا: قد يؤثر ذلك في عمل آخر غير متعلق بالدورة.
• توقّع انتقال ملف التعريف إلى طرفية خارجية: وضع التمرير يخص أوامر التطبيق.
• اعتبار الاسم والبريد إذنًا للدفع: المصادقة وصلاحيات الخادم مستقلتان.

إذا لم يعمل أمر الإصدار فافحص التثبيت وبيئة الطرفية أولًا. أما رسالة عدم وجود مستودع فتعني أن Git يعمل، لكن المجلد لا يضم مستودعًا؛ نؤجّل الإنشاء إلى الدرس الرابع.

عند اختلاف الطرفية والتطبيق أعد تشغيل التطبيق بعد التثبيت، واستخدم التحقق مجددًا (Check again) إن بقيت شاشة الاكتشاف. اقرأ المسار والإصدار من التشخيص المتاح. الزر ذو المعالجة الفارغة ليس مسار استعادة مثبتًا.

إذا حفظت ملفًا أو بدّلت إليه بالخطأ، توقّف وحدّد ما تغيّر قبل إعادة القيمة السابقة المعروفة بوسيلتها الصحيحة. لا تحذف ملفات تعريف عشوائية ولا تمسح الإعدادات العامة؛ قد تضم إعدادات لا تخص الدرس. سجل التراجع للمستودع ليس ضمانًا لاستعادة تثبيت البرامج أو إعدادات الهوية.

أجب عن كل سؤال ثم اقرأ السبب. الأسئلة المعلَّمة «مطلوب» تُحتسب لإكمال الدرس.

1. السؤال 1 من 6

   السؤال 1 من 6

   ماذا يثبت ضبط اسم الإيداع وبريده؟

   اختر إجابة واحدة.

   إيداع موقّع

   ملكية حساب المضيف

   بيانات للإيداعات المقبلة

   تحقّق من الإجابة
2. السؤال 2 من 6

   السؤال 2 من 6

   أي الخطوات لا تحفظ هوية جديدة؟

   اختر كل إجابة صحيحة.

   تعبئة النموذج ثم إلغاؤه

   تنفيذ أمر الإصدار

   تنفيذ استعلام المعاينة

   اختيار إنشاء ملف التعريف

   تحقّق من الإجابة
3. السؤال 3 من 6

   السؤال 3 من 6مطلوب

   بعد استعلام يحمل البريد demo@example.com باستخدام -c، ماذا تغيّر؟

   اختر إجابة واحدة.

   يتغيّر البريد العام

   يُنشأ مرجع main

   لا تتغيّر هوية مستمرة ولا حالة Git

   تحقّق من الإجابة
4. السؤال 4 من 6

   السؤال 4 من 6مطلوب

   غيّر البريد الممرّر في الأمر إلى maya@example.com. ما ناتج config --get user.email؟

   اختر إجابة واحدة.

   البريد الممرّر الجديد

   طلب تسجيل الدخول

   البريد التجريبي السابق

   تحقّق من الإجابة
5. السؤال 5 من 6

   السؤال 5 من 6

   يعمل git --version في الطرفية، لكن التطبيق لا يزال يقول GitTree needs Git. ماذا تفعل؟

   اختر إجابة واحدة.

   إعادة ضبط المستودع قسريًا

   افتراض عمل زر تحديد الموقع

   إعادة الاكتشاف ومقارنة مساره

   تحقّق من الإجابة
6. السؤال 6 من 6

   السؤال 6 من 6مطلوب

   نفّذ الاستعلامين وعاين النموذج وألغِه. ما الأدلة المطلوبة؟

   اختر كل إجابة صحيحة.

   ظهور البريدين بالترتيب

   لا صف جديد بعد الإلغاء

   ظهور إيداع جديد

   مسار وإصدار صالحان دون كتابة عامة

   تحقّق من الإجابة

توقّع نتيجة تغيير البريد إلى maya@example.com، ثم نفّذ استعلام المعاينة المعدّل وقارن. أعد الاستعلام الأصلي. عاين النموذج في GitTree وألغِه، ثم تأكد من عدم إضافة ملف تعريف ومن عدم إنشاء المستودع.

• افحص الملف التنفيذي والإصدار بعد التثبيت.
• هوية الإيداع بيانات مسجلة وليست مصادقة حساب.
• نطاق الأمر مؤقت، بخلاف إعداد المستودع والإعداد العام وملف التعريف المحفوظ.

• ميّز بين Git وGitTree ومزوّد الاستضافة (الدرس الأول)
• تنزيل GitTree
• Git مقابل GitHub: ما الفرق؟

Author — مؤلف؛ committer — مُودِع؛ commit — إيداع؛ profile — ملف تعريف؛ repository — مستودع؛ command palette — لوحة الأوامر. بيانات الهوية ليست توقيعًا.