سير عمل Git في Cursor

Git هو العمود الفقري لتطوير البرمجيات الحديث، ويحول Cursor التفاعل مع Git من مهمة طرفية متقطعة إلى تجربة محرر سلسة. يغطي هذا الدليل كل شيء بدءًا من عمليات Git الأساسية إلى سير العمل المتقدم، بما في ذلك استراتيجيات التفرع وصياغة الالتزامات وحل تعارضات الدمج وعمليات Git المدعومة بالذكاء الاصطناعي، كل ذلك داخل Cursor IDE.

مقدمة إلى Git في Cursor

يدمج Cursor وظائف Git بعمق في واجهة التحرير، مما يوفر لوحات التحكم في المصدر وعروض الفروق المضمنة ورسائل الالتزام المدعومة بالذكاء الاصطناعي. على عكس عملاء Git المنفصلين الذين يتطلبون تبديل السياق، يبقيك تكامل Git في Cursor في تدفق التحرير مع الحفاظ على التحكم الكامل في الإصدارات.

ميزات Git الرئيسية المتاحة في Cursor:

• لوحة التحكم في المصدر: تصور التغييرات وتجهيز الملفات والالتزام دون مغادرة المحرر
• عروض الفروق المضمنة: رؤية الأسطر المعدلة مع الإضافات والحذوفات المميزة
• رسائل الالتزام بالذكاء الاصطناعي: توليد رسائل التزام وصفية وتقليدية من تغييراتك
• إدارة الفروع: إنشاء الفروع والتبديل بينها وإدارتها عبر لوحة الأوامر
• محرر تعارضات الدمج: حل التعارضات باستخدام محرر دمج ثلاثي الاتجاهات ومساعدة الذكاء الاصطناعي

يفترض هذا الدليل معرفة أساسية بـ Git ومستودع Git مكون. جميع الأمثلة تظهر كلًا من تفاعلات المحرر المرئي وأوامر الطرفية للفهم الكامل.

إعداد Git في Cursor

قبل استخدام ميزات Git، تأكد من تكوين بيئتك بشكل صحيح.

تكوين Git

تحقق من تثبيت Git وتكوينه بهويتك:

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

يكتشف Cursor هذا التكوين ويستخدمه تلقائيًا للالتزامات. يمكن للذكاء الاصطناعي أيضًا تقديم اقتراحات واعية بالسياق بناءً على نطاق بريدك الإلكتروني، مثل التعرف على رسائل البريد الإلكتروني @company.com لاقتراح اتفاقيات خاصة بالمؤسسة.

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

لتهيئة مستودع جديد، افتح مجلد المشروع في Cursor واستخدم تكامل الطرفية:

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

لاستنساخ مستودع موجود، استخدم لوحة الأوامر (Ctrl+Shift+P) وحدد "Git: Clone" أو استخدم الطرفية:

git clone https://github.com/username/repository.git

بعد استنساخ مستودع، يقوم Cursor تلقائيًا بفهرسة تاريخ Git، مما يتيح التنقل السلس في blame ومقارنة الفروق والفروع.

تلميح

استخدم الذكاء الاصطناعي في Cursor لتوليد ملف .gitignore يطابق مجموعة التقنيات الخاصة بك. حدد package.json الخاص بك واسأل: "قم بتوليد .gitignore لهذا المشروع." سينشئ Cursor ملف تجاهل شامل مناسب لتبعياتك وعملية البناء.

استراتيجيات التفرع

التفرع الفعال ضروري للتعاون. يسرع تكامل لوحة الأوامر في Cursor عمليات الفروع، ويمكن للذكاء الاصطناعي اقتراح استراتيجيات تفرع مناسبة.

إنشاء الفروع والتبديل بينها

استخدم لوحة الأوامر (Ctrl+Shift+P) واكتب "Git: Create Branch" أو استخدم الطرفية:

git checkout -b feature/user-authentication

يعرض Cursor الفرع الحالي في شريط الحالة ويتيح التبديل السريع بين الفروع. عند إنشاء فرع جديد، يحلل الذكاء الاصطناعي سياق فرعك الحالي ويقترح اتفاقية تسمية تطابق نمط مشروعك المحدد.

استراتيجيات التفرع بمساعدة الذكاء الاصطناعي

يمكن للذكاء الاصطناعي في Cursor تحليل مستودعك والتوصية باستراتيجيات التفرع:

Git Flow:

main
  develop
    feature/login
    feature/signup
    release/1.2.0

GitHub Flow:

main
  feature/login-page
  fix/header-bug
  chore/update-deps

اسأل Cursor: "بناءً على تاريخ الالتزامات لهذا المشروع، ما هي استراتيجية التفرع الموصى بها؟" يفحص الذكاء الاصطناعي أنماط الدمج الخاصة بك ويقترح سير العمل الأنسب.

مقارنة الفروع والفروق

قارن الفروع باستخدام عرض الفروق في Cursor. استخدم لوحة الأوامر لتحديد "Git: Compare with Branch" واختر الفرع الهدف. يعرض Cursor عرض فروق جنبًا إلى جنب مع التغييرات المميزة.

لمستخدمي الطرفية:

git diff main..feature/new-feature

يمكن للذكاء الاصطناعي تحليل مخرجات الفروق عند لصقها في الدردشة. اسأل: "لخص التغييرات الرئيسية في هذا الفرق وحدد التعارضات المحتملة مع الاختبارات الموجودة."

صياغة الالتزامات وإدارتها

الالتزامات هي الوحدة الأساسية للعمل في Git. يعزز Cursor صياغة الالتزامات من خلال الرسائل المولدة بالذكاء الاصطناعي وأدوات التجهيز المرئية.

التجهيز التفاعلي

يقدم Cursor تجربة تجهيز مرئية من خلال لوحة التحكم في المصدر (Ctrl+Shift+G). يمكنك:

• تجهيز الملفات بشكل فردي بالنقر على أيقونة "+" بجانب كل ملف معدل
• مراجعة التغييرات باستخدام الفروق المضمنة قبل التجهيز
• تجهيز أسطر محددة داخل ملف (غير متاح في جميع عملاء Git، لكنه مدعوم في تنفيذ Git المدمج في Cursor)
• إلغاء تجهيز الملفات بسرعة باستخدام اختصارات لوحة المفاتيح

رسائل الالتزام المولدة بالذكاء الاصطناعي

واحدة من أكثر ميزات Git فائدة في Cursor هي توليد رسائل الالتزام بالذكاء الاصطناعي. بعد تجهيز تغييراتك، انقر على أيقونة العصا السحرية للذكاء الاصطناعي في لوحة التحكم في المصدر أو استخدم الموجه:

Generate a commit message for the staged changes following conventional commits format.

يحلل الذكاء الاصطناعي تغييراتك المجهزة ويولد:

feat(auth): implement JWT token refresh with automatic retry

- Add token refresh interceptor in axios instance
- Implement refresh token rotation
- Add automatic retry on 401 responses
- Update auth middleware to handle token expiry

يفهم الذكاء الاصطناعي في Cursor غرض تغييراتك وينتج رسائل التزام تقليدية ذات معنى. يمكنك تعديل الرسالة المولدة قبل الالتزام أو مطالبة الذكاء الاصطناعي بإعادة كتابتها بناءً على اتفاقيات مشروع محددة.

تلميح

حدد اتفاقيات رسائل الالتزام في ملف .cursorrules ليتبعها الذكاء الاصطناعي باستمرار:

Commit messages must follow conventional commits:
- feat: for new features
- fix: for bug fixes
- chore: for maintenance
- refactor: for code restructuring
- test: for test additions
- docs: for documentation changes

تخزين التغييرات

عندما تحتاج إلى تبديل الفروع ولكن لديك عمل غير مكتمل، استخدم stash:

git stash push -m "WIP: authentication middleware"

# Later, restore the stash
git stash pop

يحذر Cursor عند محاولة تبديل الفروع مع تغييرات غير مجهزة ويعرض التخزين التلقائي. يمكن للذكاء الاصطناعي المساعدة في إدارة المخازن المسماة من خلال تحليل قائمة المخازن واقتراح أسماء وصفية.

حل تعارضات الدمج

تعارضات الدمج لا مفر منها في التطوير التعاوني. يحول محرر التعارضات في Cursor ومساعدة الذكاء الاصطناعي هذا من تجربة محبطة إلى عملية قابلة للإدارة.

محرر التعارضات في Cursor

عند حدوث تعارض دمج، يعرض Cursor محرر دمج ثلاثي الاتجاهات بثلاثة عروض:

• Incoming (Theirs): التغييرات من الفرع الذي يتم دمجه
• Current (Yours): تغييرات فرع العمل الحالي الخاص بك
• Result: النتيجة المدمجة التي يمكنك تحريرها

علامات التعارض المضمنة مميزة ومشفرة بالألوان:

<<<<<<< HEAD (Current Change)
const apiUrl = process.env.API_URL || 'http://localhost:3000';
=======
const apiUrl = process.env.NEXT_PUBLIC_API_URL || 'https://api.example.com';
>>>>>>> main (Incoming Change)

يمكنك حل التعارضات عن طريق:

1. النقر على "Accept Current Change" للاحتفاظ بنسختك
2. النقر على "Accept Incoming Change" لأخذ نسختهم
3. النقر على "Accept Both Changes" لدمج النسختين بذكاء
4. تحرير النتيجة يدويًا في لوحة النتيجة

حل التعارضات بمساعدة الذكاء الاصطناعي

للتعارضات المعقدة، يحلل الذكاء الاصطناعي في Cursor كلا النسختين ويقترح دمجًا أكثر ذكاءً:

حدد كتلة التعارض واسأل: "حل تعارض الدمج هذا واشرح منطقك." سيقوم الذكاء الاصطناعي بـ:

1. تحليل كلا النسختين لفهم قصد الكود
2. شرح كلا الجانبين ولماذا يتعارضان
3. اقتراح دمج يحافظ على وظائف كلا التغييرين
4. شرح قيود الدمج المقترح

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

warning

تحقق دائمًا من صحة التعارضات التي حلها الذكاء الاصطناعي قبل إكمال الدمج. يفهم الذكاء الاصطناعي أنماط الكود لكنه قد يفوت فروق منطق الأعمال الخاصة بمتطلبات تطبيقك.

عمليات Git المدعومة بالذكاء الاصطناعي

بعد وظائف Git الأساسية، يمكن للذكاء الاصطناعي في Cursor العمل كمساعد Git، يؤدي عمليات وتحليلات معقدة.

توليد أوصاف طلبات السحب

بعد دفع فرع، اطلب من Cursor توليد وصف PR:

Generate a pull request description for the current branch comparing against main. Include:
- Summary of changes
- Motivation and context
- Testing instructions
- Screenshots or output examples
- Breaking changes checklist

يحلل الذكاء الاصطناعي التزاماتك وتغييرات الفروق وهيكل الملفات لإنشاء وصف PR شامل. هذا يقلل بشكل كبير من الوقت المستغرق في إعداد PR.

تحليل تاريخ الالتزامات

استخدم الذكاء الاصطناعي في Cursor لتحليل تاريخ الالتزامات:

Analyze the last 20 commits on this branch and identify:
1. Patterns in commit frequency
2. Files that change most frequently
3. Potential code churn issues
4. Suggested refactoring opportunities based on repeated changes

يمكن لـ Cursor أيضًا توليد تصورات لأنماط الالتزام، مما يساعد في تحديد مجالات الدين التقني التي ستستفيد من الاهتمام.

إعادة التأسيس التفاعلية

إعادة التأسيس التفاعلية قوية لكنها معقدة. يبسطها Cursor من خلال ميزات Git المرئية:

git rebase -i HEAD~5

يعرض Cursor قائمة الالتزامات في علامة تبويب محرر يمكنك تعديلها. يمكن للذكاء الاصطناعي اقتراح استراتيجيات الضغط:

Squash these commits into a single coherent commit, keeping the first commit message as the base and incorporating key details from the others.

Git Blame وتتبع الكود

تعرض تعليقات Git blame في Cursor من قام بتعديل كل سطر آخر مرة وفي أي التزام. يمكن الوصول إلى ذلك من خلال لوحة التحكم في المصدر أو بالنقر بزر الماوس الأيمن على سطر واختيار "Git: Show Blame".

يمكن للذكاء الاصطناعي تتبع تاريخ الكود عندما تسأل أسئلة مثل:

Trace the evolution of the `authenticate` function. Show me the key commits that modified it and explain why each change was made.

التكامل مع المنصات البعيدة

يمتد تكامل Git في Cursor إلى المنصات البعيدة الشائعة مثل GitHub و GitLab و Bitbucket.

تكامل GitHub

عند تسجيل الدخول إلى Cursor، يمكنك التفاعل مباشرة مع مستودعات GitHub:

• استنساخ المستودعات عبر لوحة الأوامر
• إنشاء وإدارة المشكلات وطلبات السحب
• مراجعة تغييرات PR مع تعليقات مضمنة
• دفع وسحب التغييرات بنقرة واحدة

يفهم الذكاء الاصطناعي سياق GitHub ويمكنه ربط المشكلات بـ PRs وتوليد مراجعات PR والرد على تعليقات المشكلات.

تفاعل خط أنابيب CI/CD

يمكن لـ Cursor تحليل مخرجات خط أنابيب CI/CD ووضع الأخطاء في سياقها مباشرة في المحرر:

Fix the failing CI check based on this error output:
[PASTE CI ERROR HERE]

Show me the specific file and line to modify, and explain the fix.

سير عمل Git المتقدم

للفرق والمشاريع الكبيرة، يمكّن الذكاء الاصطناعي في Cursor سير عمل Git متطور.

الالتقاط الانتقائي

طبق الالتزامات بشكل انتقائي من فرع إلى آخر:

git cherry-pick abc123f

يمكن للذكاء الاصطناعي في Cursor المساعدة في تحديد الالتزامات التي يجب التقاطها انتقائيًا:

List all commits on the `hotfix` branch that need to be cherry-picked to `main`, excluding merge commits and commits that are already present on main.

تصحيح bisect

استخدم git bisect للعثور على الالتزام الذي أدخل خطأً:

git bisect start
git bisect bad HEAD
git bisect good v1.2.0

يمكن لـ Cursor أتمتة عملية bisect عن طريق تشغيل أمر الاختبار الخاص بك في كل خطوة وتسجيل النتائج. اطلب من الذكاء الاصطناعي: "نفذ git bisect مع الأمر npm test -- -t 'authentication' وحدد الالتزام المسبب."

إدارة خطافات Git

تقوم خطافات Git بأتمتة فحوصات ما قبل الالتزام وما قبل الدفع. يمكن لـ Cursor توليد خطافات بناءً على متطلبات مشروعك:

Generate a pre-commit hook that:
- Runs ESLint on staged files
- Runs Prettier formatting
- Checks for console.log statements
- Blocks commits if any check fails

ينشئ الذكاء الاصطناعي نص الخطاف ويضمن توافقه مع نظام التشغيل وتكوين المشروع الخاص بك.

الخاتمة

يدمج سير عمل Git في Cursor التحكم في الإصدارات بسلاسة في سير عمل التطوير الخاص بك. من خلال الجمع بين أدوات Git المرئية ومساعدة الذكاء الاصطناعي، يقلل Cursor من العبء المعرفي للتحكم في الإصدارات ويساعدك في الحفاظ على كود أنظف وأكثر تنظيمًا.

النقاط الرئيسية من هذا الدليل:

• استخدم لوحة التحكم في المصدر في Cursor للتجهيز المرئي والفروق والالتزام
• قم بتوليد رسائل التزام متسقة بمساعدة الذكاء الاصطناعي
• حل تعارضات الدمج بكفاءة باستخدام محرر الدمج ثلاثي الاتجاهات واقتراحات الذكاء الاصطناعي
• حلل تاريخ الالتزامات وتتبع تطور الكود باستخدام الذكاء الاصطناعي
• قم بأتمتة أوصاف PR وخطافات Git باستخدام توليد الذكاء الاصطناعي
• تكامل بسلاسة مع GitHub و GitLab وخطوط أنابيب CI/CD

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