Git: التحقق من حالة Git وإدارة حالة الملفات

git status is one of the most commonly used commands in Git. It helps you understand the status of your current working directory and see which files have been modified, which have been staged, and which are not being tracked.

1. نظرة عامة على git status

(1) لماذا من الضروري التحقق من الحالة؟

في سير عمل Git، عليك أن تضع في اعتبارك دائمًا ما يلي:

• الملفات التي تم تعديلها: ما هي التغييرات التي أُجريت على مساحة العمل؟
• الملفات التي تم وضعها في مرحلة التحضير: المحتوى الجاهز للتثبيت
• الملفات التي لا يتم تتبعها: الملفات التي تم إنشاؤها حديثًا ولم يتم إدارتها بعد
• الفرع الحالي: ما هو الفرع الذي تعمل عليه؟
• العلاقة مع Remote: ما إذا كان متزامنًا مع Remote

يوفر git status كل هذه المعلومات ويُعد بمثابة «لوحة تحكم» لسير عمل Git.

(2) الاستخدام الأساسي

# View Full Status
git status

# View Simplified View
git status -s
# Or
git status --short

(3) قيمة المعلومات الحكومية

تساعدك معلومات الحالة على:

• تحديد الخطوة التالية: إضافة، أو تسجيل التغييرات، أو إرسال التغييرات
• تجنب ترك الملفات دون حفظ: تأكد من تسجيل جميع التغييرات
• متابعة سير العمل: الاطلاع على الوضع الحالي للعمل
• الكشف عن التغييرات غير المقصودة: تحديد الملفات التي لا ينبغي تعديلها على الفور

2. حالة الملف

(1) أربع حالات للملفات

تتخذ الملفات في Git أربع حالات رئيسية:

stateDiagram-v2
    [*] --> Untracked: Create a New File
    Untracked --> Staged: git add
    Untracked --> Untracked: Edit
    Staged --> Committed: git commit
    Committed --> Modified: Edit File
    Modified --> Staged: git add
    Staged --> Modified: Edit the temporary file
    Committed --> Committed: git commit

stateDiagram-v2
    [*] --> Untracked: Create a New File
    Untracked --> Staged: git add
    Untracked --> Untracked: Edit
    Staged --> Committed: git commit
    Committed --> Modified: Edit File
    Modified --> Staged: git add
    Staged --> Modified: Edit the temporary file
    Committed --> Committed: git commit

(2) شرح مفصل للحالات

(3) عملية انتقال الحالة

فهم انتقالات الحالات هو مفتاح إتقان استخدام Git:

graph TB
    A[Create a New File] -->|Untracked| B[Not Tracked Status]
    B -->|git add| C[Saved]
    C -->|git commit| D[Submitted status]
    D -->|Edit File| E[Status: Modified]
    E -->|git add| C
    C -->|Edit the temporary file| F[Partial Cache<br/>MMStatus]
    F -->|git add| C
    
    style B fill:#f8d7da
    style C fill:#d4edda
    style D fill:#c3e6cb
    style E fill:#fff3cd
    style F fill:#e2e3e5

graph TB
    A[Create a New File] -->|Untracked| B[Not Tracked Status]
    B -->|git add| C[Saved]
    C -->|git commit| D[Submitted status]
    D -->|Edit File| E[Status: Modified]
    E -->|git add| C
    C -->|Edit the temporary file| F[Partial Cache<br/>MMStatus]
    F -->|git add| C
    
    style B fill:#f8d7da
    style C fill:#d4edda
    style D fill:#c3e6cb
    style E fill:#fff3cd
    style F fill:#e2e3e5

▶ مثال: مراقبة تغيرات الحالة

# Initialize the repository
mkdir status-demo && cd status-demo
git init

# Create a New File
echo "# Demo Project" > README.md
echo "console.log('Hello');" > app.js

# View Status - Not tracked
git status
# On branch main
# 
# No commits yet
# 
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#         README.md
#         app.js
# 
# nothing added to commit but untracked files present

# Add a file to the staging area
git add README.md

# View Status - Partial Cache
git status
# On branch main
# 
# No commits yet
# 
# Changes to be committed:
#   (use "git rm --cached <file>..." to unstage)
#         new file:   README.md
# 
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#         app.js

3. شرح تفصيلي لمخرجات الحالة

(1) بنية المخرجات

ينقسم ناتج git status إلى عدة أجزاء:

On branch main                    ← Current branch
Your branch is up to date with 'origin/main'.  ← Long-Distance Relationships

Changes to be committed:          ← Saved Changes（Green）
  (use "git restore --staged <file>..." to unstage)
        modified:   file1.txt
        new file:   file2.txt

Changes not staged for commit:    ← Unsaved changes（Red）
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   file3.txt

Untracked files:                  ← Untracked files（Red）
  (use "git add <file>..." to include in what will be committed)
        file4.txt

no changes added to commit        ← Summary Information

(2) فهم معنى كل قسم

معلومات عن الفرع:

• On branch main: موجود حاليًا في الفرع الرئيسي
• Your branch is ahead of 'origin/main' by 2 commits: النسخة المحلية متقدمة بفارق عمليتين على النسخة البعيدة
• Your branch is behind 'origin/main' by 3 commits: المستودع المحلي متأخر بثلاثة عمليات التزام عن المستودع البعيد

منطقة التخزين المؤقت:

• سيتم تقديم هذه التغييرات خلال الجلسة القادمة لـ git commit.
• تُعرض باللون الأخضر (على الأجهزة التي تدعم الألوان)
• يشمل الملفات الجديدة والملفات المعدلة والملفات المحذوفة

منطقة غير محمية:

• تم تعديل الملف ولكن لم تتم إضافته إلى منطقة التجهيز
• معروض باللون الأحمر
• يجب عليك استخدام git add للتقديم

الملفات غير المسجلة:

• ملفات جديدة غير معروفة لدى Git
• معروض باللون الأحمر
• يجب عليك استخدام git add لإدارته

▶ مثال: تحليل مخرجات الحالة الكاملة

# Creating Complex Scenes
git init
echo "# Project" > README.md
git add README.md
git commit -m "Initial commit"

# Create files in various states
echo "new file" > new.txt           # Not tracked
echo "change" >> README.md          # Edited but not saved
echo "staged" > staged.txt
git add staged.txt                  # New files that have been cached
echo "more" >> staged.txt           # Saved and then modified

# View Full Status
git status
# On branch main
# Changes to be committed:
#   new file:   staged.txt
# 
# Changes not staged for commit:
#   modified:   README.md
#   modified:   staged.txt
# 
# Untracked files:
#   new.txt

4. نظرة عامة على الحالة

(1) تنسيق الإخراج الموجز

استخدم الخيارين -s أو --short للحصول على ناتج موجز:

git status -s

يتكون تنسيق الإخراج من عمودين: العلامات وأسماء الملفات:

XY filename

(2) معنى مؤشرات الحالة

(3) مزايا النص الموجز

• عرض سريع: اطلع على جميع الحالات في لمحة سريعة
• متوافق مع البرامج النصية: سهل التحليل والمعالجة
• توفير المساحة: تصميم مدمج، مثالي لأجهزة المستخدم النهائي
• الترميز اللوني: احتفظ بمؤشرات الألوان (الأخضر للمحتوى المخزّن مؤقتًا، والأحمر للمحتوى غير المخزّن مؤقتًا)

▶ مثال: مقارنة بين النتائج التفصيلية والموجزة

# Create Multiple States
echo "untracked" > file1.txt
echo "content" > file2.txt
git add file2.txt
echo "more" >> file2.txt
echo "tracked" > file3.txt
git add file3.txt
git commit -m "Add files"
echo "modified" >> file3.txt

# Detailed Output
git status
# On branch main
# Changes to be committed:
#   new file:   file2.txt
# 
# Changes not staged for commit:
#   modified:   file3.txt
# 
# Untracked files:
#   file1.txt

# Concise Output
git status -s
# A  file2.txt
#  M file3.txt
# ?? file1.txt

5. تتبع تغييرات الحالة

(1) التغيرات النموذجية في حالة سير العمل

دعونا نستعرض سير عمل Git الكامل:

sequenceDiagram
    participant W as Workspace
    participant S as Buffer
    participant R as Repository
    
    Note over W: 1. Create a New File
    W->>W: Status: Untracked
    
    Note over W,S: 2. git add
    W->>S: Move to the staging area
    S->>S: Status: Staged
    
    Note over S,R: 3. git commit
    S->>R: Commit to the repository
    R->>R: Status: Committed
    
    Note over W: 4. Edit File
    W->>W: Status: Modified
    
    Note over W,S: 5. git add
    W->>S: Update the temporary storage area
    S->>S: Status: Staged
    
    Note over S,R: 6. git commit
    S->>R: Submit Changes
    R->>R: Status: Committed

sequenceDiagram
    participant W as Workspace
    participant S as Buffer
    participant R as Repository
    
    Note over W: 1. Create a New File
    W->>W: Status: Untracked
    
    Note over W,S: 2. git add
    W->>S: Move to the staging area
    S->>S: Status: Staged
    
    Note over S,R: 3. git commit
    S->>R: Commit to the repository
    R->>R: Status: Committed
    
    Note over W: 4. Edit File
    W->>W: Status: Modified
    
    Note over W,S: 5. git add
    W->>S: Update the temporary storage area
    S->>S: Status: Staged
    
    Note over S,R: 6. git commit
    S->>R: Submit Changes
    R->>R: Status: Committed

(2) Special Status: Partially Cached

عندما يكون الملف قد تم وضعه في قائمة الانتظار، ولكن تم إجراء تغييرات جديدة في مساحة العمل، تظهر حالة خاصة:

# Create and stage a file
echo "version 1" > file.txt
git add file.txt
git status -s
# A  file.txt

# Continue editing the file
echo "version 2" >> file.txt
git status -s
# AM file.txt
# AIndicates that it has been saved temporarily（version 1）
# MIndicates that there are new changes in the workspace（version 2）

# Add Again
git add file.txt
git status -s
# A  file.txt
# The temporary storage area is currentlyversion 2

(3) العلاقة بين أوامر State وأوامر Git

▶ مثال: تتبع سير العمل بالكامل

# Initialization
git init status-workflow
cd status-workflow

# Steps1：Create a File（Untracked）
echo "# Project" > README.md
git status -s
# ?? README.md

# Steps2：Add to Stash（Staged）
git add README.md
git status -s
# A  README.md

# Steps3：Submit（Committed）
git commit -m "Add README"
git status
# nothing to commit, working tree clean

# Steps4：Edit File（Modified）
echo "## Features" >> README.md
git status -s
#  M README.md

# Steps5：Save Changes Temporarily（Staged）
git add README.md
git status -s
# M  README.md

# Steps6：Revise Again（Partial Cache）
echo "## Usage" >> README.md
git status -s
# MM README.md

# Steps7：Commit Staged Changes
git commit -m "Add features"
git status -s
#  M README.md  （There are still changes to be made in the workspace.）

# Steps8：Submit the remaining changes
git add README.md
git commit -m "Add usage"
git status
# nothing to commit, working tree clean

❓ أسئلة شائعة

📖 ملخص

• git status هو الأمر الأكثر استخدامًا في Git، وهو يساعدك على فهم حالة دليل العمل الحالي الخاص بك
• للملفات أربع حالات: غير مُتتبَّع، مُعدَّل، مُجهَّز، ومُثبَّت
• ينقسم إخراج الحالة إلى ثلاث فئات: «مُعدة»، و«غير مُعدة»، و«غير مُتتبعة»؛ ويشير اللون الأخضر إلى العناصر «المُعدة»، بينما يشير اللون الأحمر إلى العناصر «غير المُعدة».
• الناتج الموجز git status -s يستخدم عمودين للإشارة إلى الحالة، مما يسهل قراءته سريعًا ويجعله مناسبًا لمعالجة البرامج النصية
• في علامات الحالة XY، يمثل العمود X حالة المنطقة المؤقتة، بينما يمثل العمود Y حالة منطقة العمل.
• يُعد فهم انتقالات الحالات أمرًا أساسيًّا لإتقان سير عمل Git؛ حيث تتوافق كل حالة مع أوامر مختلفة متاحة.
• Partially staged (MM status) indicates that the file has been staged but there are new changes in the working directory.

📝 تمارين

1. تمرين أساسي: أنشئ مستودع Git. أنشئ ملفًا، ثم ضعه في قائمة التجهيز، وقم بالتثبيت، ثم عدّله، ثم ضعه في قائمة التجهيز مرة أخرى، وقم بالتثبيت مرة أخرى. استخدم git status لمراقبة التغيرات في الحالة في كل خطوة، وسجّل عملية انتقال الحالة.

2. تمرين متقدم: قم بإنشاء ملفات في حالات مختلفة (غير مُتتبَّعة، مُعدَّلة، مُعدَّة للنقل، مُعدَّة جزئيًا للنقل)، وقارن بين النتائج التفصيلية لـ git status والنتائج الموجزة لـ git status -s، وافهم معنى علامات الحالة.

3. التحدي: اكتب برنامجًا نصيًّا لتحليل مخرجات git status -s وحساب عدد الملفات في كل حالة (غير مُدرجة في المتابعة، مُعدة للنشر، مُعدَّلة، إلخ) بهدف التحقق تلقائيًّا من حالة المستودع.

فريق Web-Tutorial التقني

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

من نحن