تطوير C# في Cursor: دليل إعداد Dev Kit

تطوير C# و .NET في Cursor ممكن تماماً، لكنه يتطلب بعض الإعداد. إضافة C# Dev Kit تجلب أدوات مشابهة لـ Visual Studio إلى Cursor، ومع التكوين الصحيح، تحصل على IntelliSense، التصحيح، إنشاء المشاريع، والمزيد. يغطي هذا الدليل كل ما تحتاجه بناءً على تجربة المجتمع من سلسلة المناقشات التي ضمت 35 رداً.

المتطلبات الأساسية

قبل تثبيت C# Dev Kit، تأكد من توفر:

1. Cursor مثبت (الإصدار 0.40 أو أحدث مستحسن)
2. .NET SDK مثبت (حمّله من dotnet.microsoft.com)
3. فهم أساسي لـ C# وهيكل مشروع .NET

تحقق من تثبيت .NET:

dotnet --version

يجب أن ترى رقم إصدار مثل 8.0.100 أو 9.0.100. إذا فشل الأمر، ثبّت .NET SDK أولاً.

تثبيت إضافة C# Dev Kit

الخطوة 1: فتح لوحة الإضافات

في Cursor، اضغط Ctrl+Shift+X (أو Cmd+Shift+X على macOS) لفتح سوق الإضافات.

الخطوة 2: البحث عن C# Dev Kit

اكتب C# Dev Kit في مربع البحث. ابحث عن الإضافة الرسمية من Microsoft:

Publisher: Microsoft
Extension ID: ms-dotnettools.csdevkit

الخطوة 3: التثبيت

انقر على Install. سيقوم Cursor بتحميل وتثبيت الإضافة مع تبعياتها:

• إضافة C# (IntelliSense، تمييز الصياغة)
• .NET Install Tool
• IntelliCode for C# Dev Kit

تلميح

إذا كان زر التثبيت غير نشط أو لم تظهر الإضافة، تأكد من تحديث Cursor. بعض الإصدارات القديمة لها مشاكل توافق مع أحدث C# Dev Kit.

الخطوة 4: إعادة تحميل Cursor

بعد اكتمال التثبيت، ستظهر رسالة لإعادة تحميل النافذة. انقر على Reload لتفعيل الإضافة.

إعداد أول مشروع .NET

إنشاء مشروع جديد

مع تثبيت C# Dev Kit، لديك عدة طرق لإنشاء مشروع.

الخيار 1: باستخدام لوحة الأوامر

1. اضغط Ctrl+Shift+P (أو Cmd+Shift+P)
2. اكتب .NET: New Project
3. اختر قالب مشروع (Console App، Web API، Class Library، إلخ)
4. اختر موقع واسم لمشروعك

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

# إنشاء تطبيق وحدة تحكم جديد
dotnet new console -n MyCursorApp

# الانتقال إلى المشروع
cd MyCursorApp

# فتح في Cursor
cursor .

الخيار 3: باستخدام Solution Explorer

تضيف C# Dev Kit لوحة Solution Explorer إلى Cursor. يمكنك النقر بزر الماوس الأيمن في المساحة الفارغة واختيار Create New Project.

هيكل المشروع

يبدو مشروع .NET وحدة تحكم النموذجي كالتالي:

MyCursorApp/
├── MyCursorApp.csproj    # ملف المشروع مع التبعيات
├── Program.cs            # نقطة الدخول
└── obj/                  # مخرجات البناء (تُنشأ تلقائياً)

ملف .csproj هو حيث تدير حزم NuGet وإعدادات المشروع:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

</Project>

Target Framework

استخدم net8.0 للدعم طويل الأمد (LTS) أو net9.0 لأحدث الميزات. C# Dev Kit يدعم كليهما.

إضافة حزم NuGet

يمكنك إضافة الحزم من خلال Solution Explorer أو الطرفية:

# إضافة Entity Framework Core
dotnet add package Microsoft.EntityFrameworkCore.SqlServer

# إضافة Newtonsoft.Json
dotnet add package Newtonsoft.Json

# إضافة ASP.NET Core
dotnet add package Microsoft.AspNetCore.App

تصحيح C# في Cursor

التصحيح هو حيث تتألق C# Dev Kit حقاً. تحصل على نقاط التوقف، التصحيح خطوة بخطوة، فحص المتغيرات، وتنقل مكدس الاستدعاء.

تكوين التشغيل

في المرة الأولى التي تضغط فيها على F5 للتصحيح، سيطلب منك Cursor إنشاء ملف launch.json. اختر .NET Core من القائمة المنسدلة.

يُنشئ هذا .vscode/launch.json:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": ".NET Core Launch (console)",
      "type": "coreclr",
      "request": "launch",
      "preLaunchTask": "build",
      "program": "${workspaceFolder}/bin/Debug/net8.0/MyCursorApp.dll",
      "args": [],
      "cwd": "${workspaceFolder}",
      "console": "internalConsole",
      "stopAtEntry": false
    },
    {
      "name": ".NET Core Attach",
      "type": "coreclr",
      "request": "attach"
    }
  ]
}

ستحتاج أيضاً إلى .vscode/tasks.json لمهمة البناء:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build",
      "command": "dotnet",
      "type": "process",
      "args": [
        "build",
        "${workspaceFolder}/MyCursorApp.csproj"
      ],
      "problemMatcher": "$msCompile"
    }
  ]
}

تعيين نقاط التوقف

انقر في الهامش بجانب رقم السطر لتعيين نقطة توقف. تدعم C# Dev Kit:

• نقاط التوقف القياسية
• نقاط التوقف الشرطية (انقر بزر الماوس الأيمن على نقطة التوقف)
• Logpoints (نقاط توقف تسجل دون إيقاف التنفيذ)

ميزات التصحيح

الميزة	كيفية الوصول	ملاحظات
بدء التصحيح	F5	يعمل مع المُصحِح المرفق
التخطي	F10	تنفيذ السطر الحالي، الانتقال للتالي
الدخول	F11	الدخول إلى استدعاءات الدوال
الخروج	Shift+F11	العودة من الدالة الحالية
مراقبة المتغيرات	Debug panel > Watch	إضافة تعبيرات للمراقبة
مكدس الاستدعاء	Debug panel > Call Stack	التنقل في مكدس التنفيذ
فحص المتغيرات	مرور فوق المتغير	عرض القيمة مباشرة

تلميح

إذا لم يبدأ التصحيح، تحقق من أن مسار program في launch.json يطابق مسار ملف DLL الفعلي. يتغير المسار إذا أعدت تسمية مشروعك أو غيّرت إطار العمل المستهدف.

توافق إضافات VS Code

Cursor مبني على VS Code، لذا تعمل معظم إضافات VS Code مباشرة. ومع ذلك، هناك بعض الفروق في نظام C# البيئي.

إضافات تعمل بشكل جيد

الإضافة	الغرض	الحالة
C# Dev Kit	أدوات C# الأساسية	مدعومة بالكامل
IntelliCode for C# Dev Kit	إكمالات مدعومة بالذكاء الاصطناعي	تعمل
.NET Install Tool	إدارة SDK	تعمل
NuGet Gallery	تصفح الحزم	تعمل
REST Client	اختبار API	تعمل

مشاكل توافق معروفة

أبلغ بعض المستخدمين في سلسلة المجتمع عن مشاكل عرضية:

1. Solution Explorer لا يُحمّل: أحياناً تبقى لوحة Solution Explorer فارغة. الحل: إعادة تحميل النافذة (Ctrl+Shift+P > Developer: Reload Window).

2. تأخير IntelliSense: في الحلول الكبيرة، قد يستغرق IntelliSense بضع ثوانٍ للتهيئة. هذا طبيعي للتحميل الأول.

3. Test Explorer: مستكشف الاختبارات المدمج أحياناً لا يكتشف الاختبارات فوراً. شغّل dotnet test من الطرفية كحل بديل.

# تشغيل جميع الاختبارات
dotnet test

# تشغيل الاختبارات مع مخرجات مفصلة
dotnet test --verbosity normal

# تشغيل فئة اختبار محددة
dotnet test --filter "FullyQualifiedName~MyTestClass"

استخدام إضافات VS Code إضافية

يمكنك تثبيت إضافات VS Code أخرى تكمل تطوير C#:

• GitLens -- تكامل Git محسّن
• Error Lens -- عرض الأخطاء مباشرة
• Bracket Pair Colorizer -- مطابقة الأقواس بصرياً
• XML Tools -- لتحرير ملفات .csproj و .config

العمل مع ASP.NET Core

تدعم C# Dev Kit مشاريع ASP.NET Core بالكامل. إليك إعداد سريع:

# إنشاء مشروع Web API جديد
dotnet new webapi -n MyApi
cd MyApi
cursor .

سيُظهر Solution Explorer وحدات التحكم، النماذج، وملفات التكوين. يعمل التصحيح بنفس الطريقة -- اضغط F5 وسيتم تشغيل API مع المُصحِح المرفق.

لمشاريع Web API، قد ترغب في تحديث launch.json لاستخدام الطرفية المدمجة:

{
  "name": ".NET Core Launch (web)",
  "type": "coreclr",
  "request": "launch",
  "preLaunchTask": "build",
  "program": "${workspaceFolder}/bin/Debug/net8.0/MyApi.dll",
  "args": [],
  "cwd": "${workspaceFolder}",
  "console": "integratedTerminal",
  "env": {
    "ASPNETCORE_ENVIRONMENT": "Development"
  }
}

أفضل الممارسات لـ C# في Cursor

1. استخدام .editorconfig

أنشئ ملف .editorconfig في جذر مشروعك لفرض تنسيق متسق:

root = true

[*.cs]
indent_style = space
indent_size = 4
csharp_new_line_before_open_brace = all
csharp_prefer_braces = true
dotnet_sort_system_directives_first = true

2. تكوين إعدادات OmniSharp

إذا كنت بحاجة لتعديل خادم لغة C#، أضف الإعدادات إلى settings.json في Cursor:

{
  "omnisharp.enableRoslynAnalyzers": true,
  "omnisharp.enableEditorConfigSupport": true,
  "omnisharp.organizeImportsOnFormat": true
}

3. الاستفادة من الذكاء الاصطناعي في Cursor مع C#

تعمل ميزات الذكاء الاصطناعي في Cursor بشكل رائع مع C#. بعض الموجهات الفعالة:

"Generate a repository pattern implementation for this Entity 
Framework Core model with async CRUD operations."

"Refactor this controller to use MediatR commands instead of 
direct service calls."

"Add input validation using FluentValidation for this DTO class."

4. الحفاظ على تحديث SDK

تعمل C# Dev Kit بأفضل شكل مع إصدارات حديثة من .NET SDK. تحقق من التحديثات بانتظام:

dotnet --list-sdks
dotnet --version

5. استخدام ملفات Solution للمشاريع متعددة المشاريع

للحلول التي تحتوي على مشاريع متعددة، أنشئ ملف .sln:

dotnet new sln -n MySolution
dotnet sln add MyApi/MyApi.csproj
dotnet sln add MyApi.Tests/MyApi.Tests.csproj

سيُظهر Solution Explorer في C# Dev Kit جميع المشاريع وتبعياتها.

استكشاف المشاكل الشائعة

المشكلة	الحل
"No .NET SDK found"	ثبّت .NET SDK وأعد تشغيل Cursor
IntelliSense لا يعمل	إعادة تحميل النافذة أو التحقق من سجلات OmniSharp (Ctrl+Shift+P > OmniSharp: Show Output)
فشل البناء مع مراجع مفقودة	شغّل dotnet restore في الطرفية
المُصحِح لا يرتبط	تحقق من أن مسار launch.json يطابق ملف DLL المخرج
بطء التشغيل في الحلول الكبيرة	استبعد مجلدات bin/ و obj/ من مراقبة الملفات في الإعدادات

warning

إذا رأيت تعطل متكرر لخادم لغة C#، حاول تعطيل الإضافات الأخرى مؤقتاً لعزل التعارضات. يمكن أن تتعارض C# Dev Kit مع الإضافات القديمة التي تسجل أيضاً موفري لغة C#.

الملخص

تطوير C# في Cursor جاهز للإنتاج بمجرد تثبيت C# Dev Kit وتكوين مشروعك بشكل صحيح. تحصل على IntelliSense كامل، تصحيح، إدارة مشاريع، ودعم حزم NuGet. سير العمل قريب من Visual Studio لكن مع ميزات الذكاء الاصطناعي في Cursor.

النقاط الرئيسية:

• ثبّت إضافة C# Dev Kit الرسمية من Microsoft
• استخدم dotnet new أو Solution Explorer لإنشاء المشاريع
• اضبط launch.json و tasks.json للتصحيح
• حافظ على تحديث .NET SDK لأفضل توافق
• استخدم .editorconfig لأسلوب كود متسق

بهذا الإعداد، يصبح Cursor بيئة تطوير قوية لـ .NET، تجمع بين أدوات Microsoft لـ C# وميزات البرمجة المدعومة بالذكاء الاصطناعي في Cursor.