git config
قراءة إعدادات Git وتعديلها
يقرأ الأمر 'git config' ويكتب إعدادات محفوظة كأزواج مفتاح = قيمة. دون نطاق يعمل على المستودع الحالي (.git/config)؛ ومع --global يعمل على ملف المستخدم (~/.gitconfig) ويسري على كل مستودع في حاسوبك. إعداد المستودع يتقدّم على الإعداد العام. أول ما يحتاجه الجميع هو user.name وuser.email، ويُختمان في كل commit.
الصيغة
git config [--global | --local] <key> [<value>]
git config [--global] --unset <key>
git config [--global] --listالخيارات
اختيار الخيار المناسب
أين تُحفظ الإعدادات
الأكثر تحديدًا هو الذي يسري
| الأمر | ملف | يسري على |
|---|---|---|
--system | /etc/gitconfig | كل مستخدمي الحاسوب |
--global | ~/.gitconfig | كل مستودعاتك |
--local (default) | .git/config | هذا المستودع فقط |
أمثلة
ضبط اسمك
git config --global user.name "Ada Lovelace"يُستخدم في كل commit.
ضبط بريدك
git config --global user.email ada@example.comيُستخدم أيضًا في كل commit.
قراءة إعداد
git config user.nameيطبع القيمة السارية هنا.
اسم الفرع الافتراضي
git config --global init.defaultBranch mainسيبدأ git init على main.
أمثلة على سير العمل
git config --global user.name "Ada Lovelace"اسمك
git config --global user.email ada@example.comبريدك الإلكتروني
git config --global init.defaultBranch mainالمستودعات الجديدة تبدأ على main
حل المشكلات
Author identity unknown
السبب: user.name / user.email غير مضبوطين
اضبطهما بـ git config --global
إعداد يبدو متجاهَلًا
السبب: نطاق آخر يتجاوزه
يعرض git config --list --show-origin مصدر كل قيمة
نصائح وأخطاء شائعة
أفضل الممارسات
- ✓اضبط هويتك عامًّا، ولا تتجاوزها لكل مستودع إلا عند الحاجة (مثل بريد العمل).
- ✓تحقّق من الإعدادات بـ --show-origin حين يتصرّف شيء على نحو غير متوقَّع.
أخطاء متكررة
- ✗تسجيل commit قبل ضبط user.name وuser.email.
- ✗ضبط بريد العمل بـ --global على حاسوب شخصي، أو العكس.
- ✗مشكلات علامات الاقتباس: الأسماء التي فيها مسافات تحتاج علامات اقتباس.
الأسئلة الشائعة
~/.gitconfig (على Windows: C:\Users\<you>\.gitconfig).
git config --global core.editor "code --wait".