طريقة تهيئة مستودع Git جديد

لتهيئة مستودع Git، افتح المجلد في الطرفية ونفّذ `git init -b main`. ينشئ Git مجلدًا مخفيًا باسم .git وفرع main فارغًا. لا تكون ملفاتك متتبَّعة بعد: نفّذ git add . ثم git commit -m "Initial commit" لحفظ النسخة الأولى.

ماذا يفعل git init؟

ينشئ git init مجلد .git الذي يضم قاعدة بيانات المستودع وإعداداته وخطافاته. هذا المجلد هو المستودع نفسه، ففيه السجل كله. تبقى ملفات مشروعك في مكانها، ولا يُودَع شيء ولا يُرسل إلى أي مكان. وتنفيذه مجددًا في مستودع موجود آمن: يطبع Git عبارة Reinitialized existing Git repository ويبقي سجلك.

كيف أهيّئ مستودعًا خطوة بخطوة؟

cd my-project
git init -b main

# keep generated files out before the first add
printf "node_modules/\ndist/\n.env\n" > .gitignore

git add .
git status
git commit -m "Initial commit"

1. ينشئ git init -b main المستودع مع main فرعًا أول (Git 2.28 أو أحدث).
2. يسرد .gitignore ما يجب ألا يتتبعه Git أبدًا. اكتبه قبل أول git add، لأن الملف المتتبَّع يبقى متتبَّعًا.
3. يعرض git status ما سيحويه الإيداع الأول. افحصه بحثًا عن الأسرار ومخرجات البناء.
4. يحفظ git commit النسخة الأولى. وإن سألك Git عن هويتك، فاضبط user.name وuser.email أولًا.

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

كيف أجعل main الفرع الافتراضي؟

تنشئ الإعدادات القديمة الفرع master. اضبط القيمة الافتراضية مرة واحدة، أو أعد تسمية الفرع في مستودع ليس فيه ما يستحق إبقاء الاسم القديم:

# every new repository from now on
git config --global init.defaultBranch main

# this repository only
git branch -m master main

كيف أربط مستودعًا جديدًا بـ GitHub أو GitLab أو Bitbucket؟

أنشئ مستودعًا فارغًا على منصتك دون README أو ترخيص، حتى يتطابق السجلان. ثم أضفه مستودعًا بعيدًا وادفع:

git remote add origin git@github.com:you/my-project.git
git push -u origin main

يربط -u فرعك بالفرع البعيد، وهو ما يشرحه مقال طريقة ضبط الفرع المتتبَّع. وإن كنت تفضل عدم استخدام الأوامر إطلاقًا، فاقرأ رفع مشروع إلى GitHub دون سطر الأوامر.

ما الفرق بين git init وgit clone؟

ما الذي قد يسوء مع git init؟

نفّذت git init في المجلد الخطأ

احذف مجلد .git الذي أُنشئ للتو. تحقق أولًا بالأمر git rev-parse --show-toplevel الذي يطبع جذر المستودع، حتى تحذف المجلد الصحيح.

git rev-parse --show-toplevel
rm -rf .git

يقول Git إن المجلد not a git repository

أنت خارج أي مستودع. نفّذ git init لإنشاء واحد، أو انتقل بالأمر cd إلى المشروع أولًا.

لا يظهر مجلد فارغ في git status

يتتبع Git الملفات لا المجلدات. أضف إليه ملفًا، مثل .gitkeep، ليظهر.

ما هو git init --bare؟

يحوي المستودع المجرّد السجل دون ملفات عمل، فلا يحرر فيه أحد. تستخدم الخوادم المستودعات المجرّدة نسخة مشتركة تدفع إليها. أما لمشروع على جهازك فأنت تريد git init العادي.

راجع إنشاء مستودع لكل الخيارات، ودرس الإنشاء والنسخ والفتح للتدرب.