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

كيفية استخدام بيئات Python الموجودة في Cursor

يوفر Cursor دعماً قوياً لتطوير Python، بما في ذلك القدرة على استخدام بيئات Python الموجودة لديك. سيوضح لك هذا الدليل كيفية تكوين واستخدام أنواع مختلفة من بيئات Python في Cursor.

فهم بيئات Python في Cursor​

يدعم Cursor أنواعاً مختلفة من بيئات Python:

  • تثبيتات Python النظام
  • البيئات الافتراضية (venv)
  • بيئات Conda
  • بيئات Poetry
  • بيئات Pipenv

التكوين الأساسي​

1. إعداد مسار البيئة​

قم بتكوين بيئة Python في إعدادات Cursor:

  1. افتح إعدادات Cursor
  2. انتقل إلى قسم Python
  3. قم بتعيين مسار Python: 
    {
      "python.pythonPath": "/مسار/إلى/ملف/python/التنفيذي",
      "python.venvPath": "/مسار/إلى/البيئات/الافتراضية"
    }

2. اكتشاف البيئة​

يكتشف Cursor بيئات Python في مشروعك تلقائياً:

  • يبحث عن مجلدات venv أو .venv
  • يتحقق من requirements.txt
  • يحدد Pipfile أو pyproject.toml
  • يفحص ملفات بيئة conda

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

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

# استخدام venv
python -m venv .venv

# استخدام virtualenv
virtualenv .venv

التفعيل في Cursor​

  1. افتح لوحة الأوامر (Ctrl/Cmd + Shift + P)
  2. اختر "Python: اختيار المفسر"
  3. اختر بيئتك الافتراضية

تكامل requirements.txt​

# إنشاء requirements.txt
pip freeze > requirements.txt

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

إعداد بيئة Conda​

إنشاء بيئة Conda​

# إنشاء بيئة جديدة
conda create -n myenv python=3.9

# تصدير البيئة
conda env export > environment.yml

التكوين في Cursor​

# .cursor-env
python:
  conda_env: myenv
  conda_path: /مسار/إلى/conda

تكامل Poetry​

إعداد Poetry​

# تهيئة Poetry
poetry init

# تثبيت التبعيات
poetry install

تكوين Cursor​

# pyproject.toml
[tool.poetry]
name = "مشروعك"
version = "0.1.0"
python = "^3.9"

[tool.poetry.dependencies]
# تبعياتك

متغيرات البيئة​

متغيرات البيئة المحلية​

قم بإنشاء ملف .env:

PYTHONPATH=/مسار/إلى/الوحدات
DJANGO_SETTINGS_MODULE=مشروعي.settings
DATABASE_URL=postgresql://localhost/قاعدة_بياناتي

تكوين بيئة Cursor​

{
  "python.envFile": "${workspaceFolder}/.env",
  "python.analysis.extraPaths": [
    "${workspaceFolder}/src"
  ]
}

تكوين التصحيح​

إعداد launch.json​

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: الملف الحالي",
      "type": "python",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "justMyCode": true,
      "env": {
        "PYTHONPATH": "${workspaceFolder}"
      }
    }
  ]
}

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

البيئة غير مكتشفة​

إذا لم يكتشف Cursor بيئتك:

  1. تحقق من صحة مسار البيئة
  2. تحقق من أذونات ملف Python التنفيذي
  3. تأكد من تفعيل البيئة
  4. أعد بناء البيئة إذا لزم الأمر

مشاكل استيراد الحزم​

لمشاكل الاستيراد:

  1. تحقق من إعدادات PYTHONPATH
  2. تحقق من تثبيت الحزم
  3. تحقق من تفعيل البيئة
  4. راجع هيكل المشروع

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

لحل التعارضات:

  1. قم بإلغاء تفعيل جميع البيئات
  2. قم بإزالة معلومات Python المخزنة مؤقتاً
  3. أعد إنشاء البيئة الافتراضية
  4. أعد تثبيت الحزم

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

1. هيكل المشروع​

حافظ على هيكل مشروع واضح:

مشروع/
├── .venv/
├── src/
└── حزمتك/
├── tests/
├── requirements.txt
└── setup.py

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

  • استخدم بيئة واحدة لكل مشروع
  • حافظ على تحديث المتطلبات
  • وثق إعداد البيئة
  • استخدم التحكم في الإصدار لملفات التكوين

3. سير عمل التطوير​

  1. قم بإنشاء البيئة أولاً
  2. قم بتثبيت التبعيات
  3. قم بتكوين Cursor
  4. قم بإعداد التصحيح
  5. ابدأ التطوير

تحسين الأداء​

1. تحميل البيئة​

  • قلل حجم البيئة
  • استخدم إصدارات محددة من الحزم
  • قم بإزالة الحزم غير المستخدمة
  • حافظ على تحديث Python

2. إعدادات التحليل​

{
  "python.analysis.typeCheckingMode": "basic",
  "python.analysis.diagnosticMode": "workspace",
  "python.analysis.indexing": true
}

موارد إضافية​

  • إدارة بيئات Python
  • تصحيح كود Python
  • دليل إدارة الحزم

الخاتمة​

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