دليل Cursor للمبرمجين المبتدئين
محرر أكواد مبني على VS Code وذكاء اصطناعي يقرأ مشروعك كامل. كيف تبدأ صح، وأي المزايا تستحق وقتك فعلًا.
مبتدئ10 دقيقة قراءة
وش راح تقدر تسوي بعد هذا الشرح
- تنقل إعداداتك وإضافاتك من VS Code في أقل من خمس دقائق
- تفرّق بين الأوضاع الأربعة وتعرف متى تستخدم كل واحد
- تكتب ملف قواعد يخلي الذكاء الاصطناعي يلتزم بأسلوب مشروعك
- تراجع الاقتراحات بشكل يمنع دخول كود مكسور لمشروعك
- تعرف حدود الأداة الحقيقية قبل ما تعتمد عليها في شغل جاد
قبل ما تبدأ
- معرفة أساسية بلغة برمجة واحدة على الأقل
- خبرة سابقة بأي محرر أكواد — يفضّل VS Code
- جهاز يشغّل VS Code بسلاسة (الأداة تستهلك ذاكرة أكثر)
Cursor مو إضافة تركّبها على محررك — هو محرر كامل مبني على VS Code مع ذكاء اصطناعي مدمج في صميمه. الفرق العملي إنه يقرأ مشروعك كوحدة واحدة: يعرف بنية الملفات، الاستيرادات، والأنماط اللي تستخدمها، فاقتراحاته تجي مناسبة لمشروعك أنت مو لمشروع عام.
هذا يخليه قويًا وخطيرًا في نفس الوقت. قوي لأنه يختصر شغل ساعات، وخطير لأن الاقتراح اللي يبدو صحيحًا ويمر بسهولة هو أخطر من الاقتراح اللي ينكسر فورًا.
لمن يناسب هذا الشرح
إذا عندك أساس في لغة برمجة واحدة على الأقل وتعرف تقرأ كودًا كتبه غيرك، هذا الشرح لك. إذا لسه في أول أسبوع تعلّم برمجة، الأفضل تأجل الأداة شوي — لأن قيمتها الحقيقية تظهر لما تقدر تحكم على مخرجاتها.
ملاحظة قبل ما تبدأ
كل ما تحت مبني على أن الكود اللي تشتغل عليه ملكك أو مسموح لك تشاركه. لو تشتغل على كود شركة، راجع سياسة الخصوصية وفعّل وضع الخصوصية قبل أول سطر.
الخطوات
الخطوة 1: ثبّت الأداة وانقل إعداداتك
نزّل Cursor من موقعه الرسمي. لأنه مبني على VS Code، أول ما تفتحه بيعرض عليك استيراد الإضافات والاختصارات والثيم من VS Code بضغطة واحدة. اقبل العرض — بتلقى بيئتك المعتادة كما هي، بدون إعادة ضبط أي شي.
ملاحظة: لو ما ظهر العرض، تلقاه في لوحة الأوامر: اضغط Ctrl+Shift+P واكتب Import.
الخطوة 2: افهم الفرق بين الأوضاع الأربعة
Tab يكمّل السطر أو الكتلة اللي تكتبها ويستخدم بضغطة واحدة. Inline (Ctrl+K) يعدّل الكود المحدد بأمر تكتبه بالعربي أو الإنجليزي. Chat (Ctrl+L) للأسئلة والنقاش بدون تعديل مباشر. Agent ينفّذ مهمة كاملة عبر عدة ملفات لحاله. المبتدئ يبدأ بالأولين، ويأجل الـAgent لين يتعوّد على مراجعة الكود بسرعة.
ملاحظة: الاختصارات هي الفرق بين أداة سريعة وأداة مزعجة. احفظ Ctrl+K وCtrl+L من اليوم الأول.
الخطوة 3: أعطه سياق مشروعك بدل ما تشرح كل مرة
استخدم @ داخل مربع الدردشة عشان تشير لملف أو مجلد أو رمز محدد: @src/api/users.ts يخليه يقرأ الملف قبل ما يجاوب. هذي أهم عادة تتعلمها — السؤال بدون سياق يعطيك جوابًا عامًا، والسؤال مع ملفين مرتبطين يعطيك جوابًا يناسب مشروعك أنت.
ملاحظة: تقدر تشير للأخطاء مباشرة بـ @ ثم اسم الخطأ من الطرفية، فيقرأ رسالة الخطأ الكاملة.
الخطوة 4: اكتب ملف قواعد المشروع
أنشئ ملفًا باسم AGENTS.md أو .cursor/rules في جذر مشروعك واكتب فيه القواعد اللي تبي الأداة تلتزم بها: اللغة، نمط التسمية، المكتبات الممنوعة، طريقة معالجة الأخطاء، هل تكتب تعليقات ولا لا. الأداة تقرأ الملف تلقائيًا مع كل طلب، فتوفر عليك تكرار نفس التعليمات.
ملاحظة: خلّ القواعد قصيرة ومحددة. ملف من عشرين سطرًا واضحًا أنفع من ملف من مئتي سطر عام.
الخطوة 5: راجع كل تعديل قبل ما تقبله
الأداة تعرض تعديلاتها كفرق (diff) بالأخضر والأحمر. لا تضغط قبول بشكل آلي. اقرأ التعديل سطرًا سطرًا، خصوصًا في ملفات ما فتحتها أنت. الاقتراح ممكن يكون شغّال ويكسر شيئًا ثانيًا في نفس الوقت — وهذي أكثر مشكلة تصير مع المبتدئين.
ملاحظة: اشتغل على فرع Git منفصل وأنت تجرّب Agent. الرجوع للخلف يصير بأمر واحد بدل ما تصلّح يدويًا.
الخطوة 6: استخدمه في الشرح، مو بس في الكتابة
أفضل استخدام للمبتدئ فعليًا مو توليد الكود — بل فهمه. حدد أي دالة معقدة واضغط Ctrl+L واسأل: «اشرح لي وش تسوي هذي الدالة خطوة بخطوة، ووش الحالات اللي ممكن تفشل فيها». هذا يختصر ساعات على من يشتغل في مشروع قائم ما كتبه هو.
ملاحظة: اسأله «وش البدائل لهذا الحل ووش عيوب كل واحد؟» — يعلّمك أكثر من مجرد قبول أول اقتراح.
أخطاء شائعة — وكيف تتجنبها
الخطأتقبل اقتراحات Tab بشكل تلقائي وأنت تكتب بسرعة.
الصحاقرأ الاقتراح قبل ما تضغط. القبول الآلي هو أسرع طريقة لإدخال أخطاء صامتة.
الخطأتشغّل Agent على مشروع كامل بدون Git.
الصحاعمل commit قبل أي مهمة كبيرة. بدون هذا، التراجع عن تعديل عبر عشرة ملفات كابوس.
الخطأتسأل سؤالًا عامًا بدون ما تشير لأي ملف.
الصحاستخدم @ دائمًا. السياق هو كل الفرق بين جواب مفيد وجواب من ويكيبيديا.
الخطأتعتمد عليه في الكود الحسّاس: المصادقة، الدفع، صلاحيات الوصول.
الصحاستخدمه كمسوّدة في هذي المواضع فقط، وراجع كل سطر بنفسك أو مع مبرمج أخبر منك.
الخطأتترك ملف القواعد فاضي وتشتكي إن الكود ما يشبه أسلوب مشروعك.
الصحعشرون سطرًا في ملف القواعد توفر عليك مئة تصحيح لاحق.
❓ أسئلة شائعة
هل Cursor مجاني؟
فيه خطة مجانية فيها عدد محدود من الطلبات الذكية شهريًا، وتكفي للتجربة والمشاريع الصغيرة. الاستخدام اليومي الجاد يحتاج اشتراكًا مدفوعًا. راجع صفحة التسعير الرسمية للأرقام الحالية.
هل يشتغل مع أي لغة برمجة؟
نعم، أي لغة يدعمها VS Code. الجودة أعلى في اللغات الشائعة مثل JavaScript وTypeScript وPython، وأقل في اللغات النادرة أو الأطر الجديدة جدًا.
هل كودي يُرسل لسيرفراتهم؟
افتراضيًا نعم، لأن المعالجة تصير في السحابة. فيه وضع خصوصية (Privacy Mode) يمنع تخزين الكود. لو تشتغل على كود ملكية شركة، فعّله وراجع سياسة الأداة مع فريقك قبل الاستخدام.
أنا مبتدئ تمامًا — هل يضرني الاعتماد عليه؟
يضرك لو استخدمته كبديل عن الفهم. استخدمه كشارح ومراجع أولًا: اكتب الكود بنفسك، بعدين اسأله يراجعه ويشرح لك أخطاءك. بهالطريقة يسرّع تعلمك بدل ما يعطله.
وش الفرق بينه وبين GitHub Copilot؟
Copilot إضافة تركّز على إكمال الكود داخل محررك الحالي. Cursor محرر كامل يفهم المشروع كوحدة واحدة ويقدر يعدّل عدة ملفات في مهمة واحدة. لو شغلك تعديلات موزّعة، Cursor أنسب.