يركز شرح Cursor للمبتدئين على بداية صغيرة يمكنك فهمها ومراجعتها: إنشاء صفحة ويب محلية، ثم تعديل جزء منها واختباره. Cursor يساعدك في قراءة ملفات المشروع وكتابة الكود وإصلاح المشكلات، لكن لا يجعل كل كود يولده صحيحًا ولا يغني عن تعلم الأساسيات.
سنستخدم تمرينًا مقترحًا بملفات HTML وCSS وJavaScript، دون تسجيل دخول أو قاعدة بيانات أو خدمات مدفوعة. المسار مستند إلى وثائق Cursor الرسمية، والأوامر العربية أمثلة قابلة للتعديل وليست مشروعًا نعلن اختباره على جميع الأجهزة. أسماء القوائم والميزات تتغير بين الإصدارات.
قبل اعتماد Cursor للعمل اليومي، يمكنك مراجعة مقارنة Cursor وGitHub Copilot وDevin Desktop. ستساعدك على اختيار المساعد وفق بيئة التطوير وطبيعة المهمة ومقدار التحكم الذي تحتاجه، ثم تطبيق التمرين هنا إذا اخترت Cursor.
ما Cursor وكيف يختلف عن محادثة عامة؟
Cursor بيئة عمل للبرمجة مع مساعد ذكاء اصطناعي يمكنه التعامل مع سياق المشروع. بدل نسخ ملفات كثيرة إلى نافذة محادثة، يقرأ المساعد الملفات ذات الصلة ويقترح تغييرات، ويمكن لوضع Agent تعديل ملفات وتشغيل أوامر حسب الصلاحيات. هذا مفيد عندما تريد تفسير كود موجود أو تنفيذ تعديل محدد ومراجعته.
أما المساعد العام فيمكن أن يساعدك في شرح مفهوم أو صياغة طلب، لكن نسخ رده إلى المشروع يظل خطوة منفصلة في كثير من الحالات. إذا كنت جديدًا على كتابة التعليمات، ابدأ بـدليل استخدام ChatGPT للمبتدئين ثم طبق مبدأ تحديد الهدف والسياق والقيود داخل Cursor.
ما الذي تحتاج إليه قبل التثبيت؟
- جهاز يدعم الإصدار الحالي واتصالًا بالإنترنت لاستخدام الميزات السحابية.
- حساب Cursor وخطة مناسبة للتجربة.
- مجلد جديد للتدريب، بعيد عن مشاريع العملاء والملفات الخاصة.
- معرفة بسيطة بمعنى الملف والمجلد، واستعداد لقراءة التغييرات وتجربتها.
تذكر وثائق البداية الرسمية دعم Windows 10 وما بعده، إلى جانب إصدارات macOS وLinux الموضحة فيها. نزّل النسخة المناسبة من الموقع الرسمي، واتبع تعليمات التثبيت وتسجيل الدخول. لا تبدأ بتنزيل نسخة معدلة تعدك باشتراك مجاني.
فتح أول مشروع واختيار طريقة العمل
- أنشئ مجلدًا باسم واضح مثل
my-first-page. - افتح Cursor ثم اختر File ثم Open Folder، وحدد المجلد.
- افتح لوحة المساعد من الواجهة؛ يوضح الدليل اختصار Ctrl + I في Windows.
- ابدأ بسؤال للفهم والتخطيط، ثم انتقل إلى التعديل عندما تكون المهمة واضحة.
- بعد أي تعديل، افتح الملفات وراجع الفروق قبل متابعة المهمة التالية.
إذا كان وضع Ask متاحًا في نسختك، فهو مناسب للاستكشاف والأسئلة دون تعديل الملفات. أما Agent فمخصص للتنفيذ ويمكنه إجراء تغييرات فعلية. راجع الوضع المختار والصلاحيات؛ كتابة «لا تعدّل» داخل الرسالة وحدها ليست بديلًا عن اختيار نمط مناسب وحدود واضحة.
| ما تريده | طريقة البداية | الناتج المتوقع |
|---|---|---|
| فهم ملف | سؤال مع الإشارة إلى الملف | شرح ومسار قراءة |
| تحديد خطة | طلب خطة صغيرة قبل التنفيذ | خطوات ومتطلبات |
| إنشاء أو تعديل كود | Agent مع نطاق محدد | تغييرات يجب مراجعتها |
| تشخيص مشكلة | وصف ما يحدث وما يفترض حدوثه | تفسير وإصلاح مقترح |
تمرين عملي: صفحة تعريف عربية من ثلاثة ملفات
اختر صفحة بسيطة تعرض اسم مشروع، ووصفًا قصيرًا، وزرًا يُظهر رسالة داخل الصفحة. لا تجعل التمرين متجرًا أو منصة عضويات؛ لأن هذه الوظائف تضيف أمنًا واستضافة وإدارة بيانات قبل إتقان الأساسيات.
يمكنك بدء الطلب التالي:
أنشئ صفحة تعريف عربية باتجاه من اليمين إلى اليسار في هذا المجلد. استخدم index.html وstyle.css وscript.js فقط. الصفحة تحتوي عنوانًا ووصفًا قصيرًا وزرًا يظهر رسالة داخل الصفحة. لا تستخدم مكتبات أو اتصالات خارجية أو صورًا. اشرح دور كل ملف وكيف أفتح الصفحة محليًا. اجعل التصميم يعمل على الهاتف والكمبيوتر.
اقرأ ما يقترحه المساعد قبل تنفيذ أوامر إضافية. هذا التمرين لا يفترض الحاجة إلى تثبيت حزم؛ إذا اقترحها، اطلب منه تفسير السبب والعودة إلى ملفات المتصفح البسيطة. افتح index.html في متصفحك بعد إنشاء الملفات وحفظها، ثم قارن النتيجة بالمتطلبات المكتوبة.
بعدها اطلب تغييرًا واحدًا: «غيّر نص الرسالة إلى أهلاً بك في مشروعي، مع الحفاظ على أسماء الملفات وباقي السلوك». التعديل الصغير يجعل مراجعة الفروق أسهل، ويكشف إن كان المساعد غيّر أجزاء لا علاقة لها بالمهمة.
اختبر النتيجة بدل الاكتفاء بعبارة تم
- هل يظهر العنوان والوصف بالعربية ويعمل اتجاه النص؟
- هل يظهر الزر في شاشة صغيرة دون خروج الصفحة عن العرض؟
- هل يعمل النقر مرة واحدة وتكراره بالطريقة المتوقعة؟
- هل يمكن الوصول إلى الزر بلوحة المفاتيح وتشغيله؟
- هل أسماء ملفات CSS وJavaScript ومساراتها مطابقة لما في HTML؟
- هل توجد أخطاء في وحدة تحكم المتصفح؟
إذا لم تظهر الألوان أو لم يعمل الزر، تحقق أولًا من حفظ الملفات وفتح الملف الصحيح. سجّل الخطأ الفعلي؛ مثل «الزر يظهر لكنه لا يغيّر الرسالة» بدل «كل شيء لا يعمل». لا ترسل بيانات خاصة ضمن لقطة الخطأ أو سجل طويل لا يحتاج إليه التشخيص.
كيف تطلب إصلاحًا واضحًا من Cursor؟
اجمع أربع معلومات: الخطوة التي نفذتها، وما توقعته، وما حدث فعلًا، ورسالة الخطأ إن وجدت. مثال مقترح: «فتحت index.html وضغطت الزر. توقعت ظهور رسالة أسفل الزر، لكن لم تتغير الصفحة. راجع ربط script.js ومعرّف الزر، وأصلح السبب دون إضافة مكتبات».
يمكنك الإشارة إلى ملف محدد باستخدام خيارات السياق المتاحة أو رمز @ كما تشرح وثائق أول مشروع. أعطِ المساعد الملف اللازم، ولا ترفع مشروعًا كاملًا لمجرد سؤال عن سطر واحد.
مراجعة الكود والرجوع عن التغييرات
تشير وثائق Agent إلى أن التعديلات تطبق أثناء عمله، وتراجع في عرض الفروق. راقب الملفات التي تغيرت واسأل عن سبب أي تغيير خارج النطاق. لا تنتظر نهاية مهمة كبيرة لتكتشف أن ملفًا مهمًا استُبدل.
احتفظ بنسخة قبل التعديل، ثم تعلّم Git لحفظ مراحل واضحة تستطيع الرجوع إليها. قد تظهر ميزة Restore Checkpoint للعودة إلى مرحلة سابقة، لكنها ليست نسخة احتياطية كاملة لكل آثار الأوامر أو الخدمات الخارجية. النسخة المحلية والتوثيق البسيط مفيدان حتى في تمرينك الأول.
الصلاحيات والخصوصية وحدود الأتمتة
لا تضع كلمات المرور أو مفاتيح API أو بيانات العملاء في مجلد التدريب. راجع سياسة الخصوصية وإعدادات حسابك قبل استخدام مشاريع خاصة. لا تفترض أن معالجة الكود تحدث محليًا بالكامل.
توضح وثائق أمان Agent أن تعديلات ملفات العمل قد تحفظ مباشرة، وأن التشغيل التلقائي أثناء التطوير قد ينفذ تغييرات قبل مراجعتها. لذلك استخدم مشروع تدريب معزولًا ولا توافق على أمر حذف أو تثبيت أو اتصال خارجي لا تفهم سببه.
هل Cursor مجاني وما الخطة المناسبة للبداية؟
تعرض صفحة الأسعار الرسمية خيارًا مجانيًا بحدود استخدام وخططًا مدفوعة. تختلف الإمكانات والنماذج والرصيد؛ تجنب الاعتماد على جدول أسعار قديم أو افتراض عدد ثابت من الرسائل.
ابدأ بالخيار المتاح لك لتجربة المشروع الصغير، ثم راجع الاستهلاك الفعلي. إذا وصلت إلى الحد، لا تشترِ خطة فقط لإكمال طلب واسع يمكن تبسيطه. حدّد هل المشكلة في الرصيد أم في وصف المهمة، واقرأ شروط التجديد وأي تكلفة إضافية قبل الدفع.
هل يغني Cursor عن تعلم البرمجة؟
يساعدك في التعلم والإنتاج، لكنه لا يتحمل عنك مسؤولية فهم الناتج وصيانته. تعلّم في هذا التمرين دور HTML للمحتوى وCSS للتنسيق وJavaScript للسلوك. بعد ذلك انتقل إلى مشروع أكبر على مراحل. يمكنك الاستفادة من قسم البرمجة والتطوير لمتابعة الأدلة القادمة دون القفز مباشرة إلى تطبيق معقد.
