انتقل إلى المحتوى الرئيسي

كيفية تفعيل البيئات الافتراضية في Cursor: دليل بيئة Python

تعتبر إدارة البيئات الافتراضية لـ Python في Cursor أمرًا ضروريًا للحفاظ على بيئات تطوير نظيفة ومعزولة. يغطي هذا الدليل كل ما تحتاج معرفته حول استخدام virtualenv مع Cursor.

فهم البيئات الافتراضية​

ما هي البيئة الافتراضية (Virtualenv)؟​

البيئة الافتراضية هي بيئة Python معزولة تتيح لك:

  • تثبيت الحزم دون التأثير على المشاريع الأخرى
  • الاحتفاظ بإصدارات مختلفة من نفس الحزمة
  • الحفاظ على تثبيت Python العالمي نظيفًا

إعداد Virtualenv​

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

  1. تثبيت Python على نظامك
  2. تثبيت محرر Cursor
  3. معرفة أساسية بأوامر الطرفية (Terminal)

خطوات التثبيت​

# تثبيت virtualenv إذا لم يكن مثبتًا بالفعل
pip install virtualenv

# للإصدارات الأحدث من Python، يمكنك أيضًا استخدام
python -m pip install virtualenv

إنشاء بيئة افتراضية​

الطريقة الأولى: استخدام الطرفية في Cursor​

  1. افتح الطرفية المدمجة في Cursor
  2. انتقل إلى دليل مشروعك
  3. أنشئ بيئة افتراضية جديدة:
# بيئة افتراضية أساسية
virtualenv venv

# تحديد إصدار Python
virtualenv -p python3.9 venv

# استخدام وحدة venv المدمجة في Python
python -m venv venv

الطريقة الثانية: استخدام لوحة أوامر Cursor​

  1. اضغط على Ctrl+Shift+P (Windows/Linux) أو Cmd+Shift+P (macOS)
  2. اكتب "Python: Create Environment"
  3. اختر "Venv"
  4. اختر إصدار مترجم Python

تفعيل البيئة الافتراضية​

نظام Windows​

# موجه الأوامر (Command Prompt)
venv\Scripts\activate.bat

# باور شل (PowerShell)
venv\Scripts\Activate.ps1

نظام macOS/Linux​

source venv/bin/activate

إعدادات خاصة بـ Cursor​

تعيين مترجم Python الافتراضي​

  1. افتح لوحة الأوامر
  2. اكتب "Python: Select Interpreter"
  3. اختر Python الخاص بالبيئة الافتراضية

تكوين تكامل الطرفية​

  1. افتح إعدادات Cursor
  2. انتقل إلى إعدادات الطرفية
  3. أضف تفعيل البيئة الافتراضية إلى الملف الشخصي
{
  "terminal.integrated.profiles.windows": {
    "Python Env": {
      "path": "cmd.exe",
      "args": ["/K", "venv\\Scripts\\activate.bat"]
    }
  }
}

إدارة الحزم​

تثبيت الحزم​

# تأكد من تفعيل البيئة الافتراضية
pip install package_name

# التثبيت من ملف requirements.txt
pip install -r requirements.txt

إنشاء ملف المتطلبات​

pip freeze > requirements.txt

استكشاف الأخطاء وإصلاحها​

المشكلات الشائعة​

  1. فشل التفعيل

    # سياسة تنفيذ PowerShell في Windows
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

  2. مشكلات المسار

    • تحقق من موقع البيئة الافتراضية
    • تحقق من تثبيت Python
    • تأكد من متغيرات PATH

  3. أخطاء الصلاحيات

    • قم بالتشغيل كمسؤول إذا لزم الأمر
    • تحقق من أذونات الملفات
    • تحقق من حقوق وصول المستخدم

أفضل الممارسات​

تنظيم المشروع​

  1. هيكل الدليل

    project/
    ├── venv/
    ├── src/
    ├── tests/
    ├── requirements.txt
    └── .gitignore

  2. تكامل Git

    # أضف إلى .gitignore
    venv/
    __pycache__/
    *.pyc

إدارة البيئة​

  1. بيئات متعددة

    • بيئة التطوير
    • بيئة الاختبار
    • بيئة الإنتاج

  2. إدارة الإصدارات

    • تثبيت إصدارات الحزم
    • توثيق التبعيات
    • استخدام بيئة افتراضية لكل مشروع

الاستخدام المتقدم​

استخدام إصدارات Python مختلفة​

# إنشاء بيئة باستخدام إصدار Python محدد
virtualenv -p python3.8 venv38
virtualenv -p python3.9 venv39

العمل مع مشاريع متعددة​

  1. إعدادات خاصة بالمشروع

    {
      "python.defaultInterpreterPath": "${workspaceFolder}/venv/bin/python"
    }

  2. تكوين مساحة العمل

    • إنشاء .vscode/settings.json
    • تعيين مسار Python خاص بالمشروع
    • تكوين متغيرات البيئة

الخلاصة​

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

لمزيد من المعلومات:

آخر تحديث: فبراير 2025 - يغطي هذا الدليل إصدار Cursor 0.43 و Python 3.x.