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

كيفية تفعيل Virtualenv في Cursor: دليل بيئة Python

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

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

ما هو Virtualenv؟​

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

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

إعداد Virtualenv​

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

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

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

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

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

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

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

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

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

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

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

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

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

Windows​

# موجه الأوامر
venv\Scripts\activate.bat

# PowerShell
venv\Scripts\Activate.ps1

macOS/Linux​

source venv/bin/activate

تكوين خاص بـ Cursor​

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

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

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

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

إدارة الحزم​

تثبيت الحزم​

# تأكد من تفعيل virtualenv
pip install اسم_الحزمة

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

إنشاء ملف Requirements​

pip freeze > requirements.txt

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

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

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

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

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

    • تحقق من موقع virtualenv
    • تحقق من تثبيت Python
    • تأكد من متغيرات PATH

  3. أخطاء الأذونات

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

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

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

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

    مشروع/
    ├── 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.