🔝 الدليل الرئيسي للسلسلة: بايثون: لغة ومنظومة وأطر للمطوّرين

قبل كتابة أي سطر من كود بايثون، يجب توفير بيئة تطوير وظيفية ومُعدّة جيدًا. البيئة المُثبتة بشكل سيئ — بايثون عام مُلوَّث بحزم متفرقة، غياب بيئة افتراضية، محرّر بدون دعم اللغة — هي المصدر الأول لإحباط المطوّرين المبتدئين وأحد الأسباب الرئيسية للأخطاء صعبة التشخيص. يستعرض هذا الدرس التثبيت الكامل تحت Linux (Ubuntu/Debian) وmacOS وWindows، وإنشاء بيئة افتراضية بـ venv، وإعداد VS Code للتطوير الاحترافي ببايثون.

المتطلبات

جهاز كمبيوتر بنظام Linux (Ubuntu 22.04 / 24.04 LTS أو Debian 12)، أو macOS 13+، أو Windows 10/11
صلاحيات المسؤول أو sudo على الجهاز
اتصال بالإنترنت لتحميل بايثون والأدوات
المستوى: مبتدئ — لا تتطلب معرفة سابقة ببايثون
الوقت المُقدَّر: 30 إلى 45 دقيقة

الخطوة 1 — التحقق من تثبيت بايثون مسبقًا

قبل تثبيت أي شيء، من الحكمة التحقق مما إذا كان بايثون موجودًا بالفعل على النظام وأي إصدار متوفر. على Linux وmacOS، Python 3 مُثبَّت مسبقًا غالبًا من قبل نظام التشغيل، لكنه في الغالب إصدار قديم مخصص لأدوات النظام — من الأفضل عدم استخدامه للتطوير الشخصي لتجنّب التعارضات مع حزم النظام.

python3 --version
# أو على Windows :
python --version

إذا ظهر Python 3.12 أو 3.13، فمُفسّر النظام حديث. إذا حصلت على command not found أو إصدار 2.x، انتقل مباشرة إلى الخطوة التالية.

الخطوة 2 — التثبيت تحت Linux (Ubuntu/Debian)

الطريقة الأسهل هي استخدام apt. تحت Ubuntu 24.04 LTS، Python 3.12 مُضمَّن افتراضيًا. لـ Python 3.13، أضف PPA deadsnakes المُصان مجتمعيًا.

sudo apt update
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.13 python3.13-venv python3.13-dev
python3.13 --version

الحزمة python3.13-venv ضرورية لإنشاء بيئات افتراضية. الحزمة python3.13-dev تُثبّت رؤوس C اللازمة لتجميع مكتبات بامتدادات أصلية مثل psycopg2.

الخطوة 3 — التثبيت تحت macOS

الطريقة المُوصى بها هي Homebrew. إذا لم يكن مُثبَّتًا، توجّه إلى brew.sh للأمر الرسمي.

brew install python@3.13
echo 'export PATH="/opt/homebrew/opt/python@3.13/bin:\$PATH"' >> ~/.zshrc
source ~/.zshrc
python3.13 --version
pip3.13 --version

Homebrew يُثبّت Python في /opt/homebrew/ على Apple Silicon أو /usr/local/ على Intel.

الخطوة 4 — التثبيت تحت Windows

حمّل المُثبِّت الرسمي من python.org/downloads/windows. حدّد إلزاميًا الخيار Add Python 3.13 to PATH أثناء التثبيت. بعد التثبيت، افتح PowerShell جديد:

python --version
pip --version

إذا لم يُتعرَّف على python رغم تحديد الخيار، أغلق الطرفية كليًا وافتح واحدة جديدة. WSL 2 مع Ubuntu بديل مُقدَّر لمطوّري Python على Windows.

الخطوة 5 — إنشاء وتفعيل بيئة افتراضية

البيئة الافتراضية مجلد معزول. الوحدة venv مُدمجة في Python منذ 3.3.

mkdir mon-projet-python
cd mon-projet-python
python3.13 -m venv .venv

# Linux/macOS :
source .venv/bin/activate

# Windows PowerShell :
.venv\Scripts\Activate.ps1

# Windows cmd :
.venv\Scripts\activate.bat

اصطلاح .venv (بالنقطة) يُخفي المجلد ويُشير إلى أنه إعداد. بعد التفعيل، يعرض الموجه (.venv) كبادئة. لتعطيل البيئة: deactivate.

الخطوة 6 — إعداد .gitignore

git init
cat > .gitignore << 'EOF'
.venv/
venv/
env/
__pycache__/
*.py[cod]
*.pyo
*.pyd
.Python
dist/
build/
*.egg-info/
.pytest_cache/
.coverage
htmlcov/
.vscode/settings.json
.idea/
*.swp
.env
.env.local
EOF
git add .gitignore
git commit -m "init: projet Python avec .gitignore"

الـ heredoc << 'EOF' بأقواس حول EOF يُنشئ ملفًا متعدد الأسطر بدون استكمال متغيّرات shell. ملف .env مُتجاهَل لاحتوائه على مفاتيح API ولا يجب أن يدخل Git أبدًا.

الخطوة 7 — أوامر pip الأساسية

مع تفعيل venv، pip يُشير إلى الإصدار المعزول:

pip install --upgrade pip
pip install requests
pip install django==5.1.4
pip install -r requirements.txt
pip freeze > requirements.txt
pip list
pip show requests
pip uninstall requests

pip freeze > requirements.txt يُثبّت الإصدارات الدقيقة. يجب حفظه مع الكود لإعادة إنشاء البيئة. للمشاريع الطويلة الأمد، pip-tools (pip-compile) أو Poetry/uv تفصل التبعيات المباشرة عن الانتقالية.

الخطوة 8 — إعداد VS Code

ثبّت VS Code من code.visualstudio.com. الإضافات اللازمة:

Python (ms-python.python) — الدعم الأساسي، debugger
Pylance (ms-python.vscode-pylance) — خادم لغة سريع، autocomplete ذكي
Ruff (charliermarsh.ruff) — linter وformatter فائق السرعة

اختر مفسّر venv: Ctrl+Shift+P → « Python: Select Interpreter » → .venv/bin/python (Linux/macOS) أو .venv\Scripts\python.exe (Windows).

ملف .vscode/settings.json مُوصى به:

{
  "python.defaultInterpreterPath": "WORKSPACE_FOLDER/.venv/bin/python",
  "editor.formatOnSave": true,
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.codeActionsOnSave": {
      "source.fixAll.ruff": "explicit",
      "source.organizeImports.ruff": "explicit"
    }
  },
  "python.analysis.typeCheckingMode": "basic"
}

استبدل WORKSPACE_FOLDER بـ \${workspaceFolder} (متغيّر VS Code المدمج). هذا يُفعّل التنسيق التلقائي عند الحفظ، تنظيم الاستيرادات، والفحص الأساسي للأنواع.

الخطوة 9 — التحقق النهائي

pip install requests

cat > test_install.py << 'EOF'
import sys
import requests
print(f"Python version : {sys.version}")
print(f"requests version : {requests.__version__}")
response = requests.get("https://httpbin.org/get", timeout=5)
print(f"Statut HTTP : {response.status_code}")
if response.status_code == 200:
    data = response.json()
    print(f"Origine IP : {data.get('origin', 'inconnue')}")
    print("✓ Installation Python complète et fonctionnelle !")
EOF

python test_install.py

الإخراج المتوقع يعرض إصدار Python 3.13.x، إصدار requests 2.32.x، وحالة HTTP 200. إذا لم يكن الإصدار 3.13.x، venv ليس مُفعَّلًا — أعد source .venv/bin/activate.

أخطاء شائعة

الخطأ	السبب	الحل
`python3.13: command not found`	Python غير في PATH	تحقق من التثبيت وأعد تشغيل الطرفية
`No module named 'venv'`	python3.13-venv مفقود (Linux)	`sudo apt install python3.13-venv`
pip يُعدّل Python العام	venv غير مُفعَّل	`source .venv/bin/activate`
VS Code يستخدم مفسّر خطأ	الاختيار لم يُنفَّذ	Ctrl+Shift+P → Python: Select Interpreter
`Activate.ps1 لا يُحمَّل` (Windows)	سياسة PowerShell مقيّدة	`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`

الأسئلة الشائعة

هل يمكن عدة إصدارات Python على نفس الجهاز؟
نعم. على Linux، تتعايش عبر python3.11، python3.13. pyenv هو الأداة القياسية لإدارة عدة إصدارات على macOS وLinux مع تبديل لكل مجلد عبر .python-version.

venv أو virtualenv أو conda؟
venv مُدمج في Python منذ 3.3 ويكفي لغالبية المشاريع. virtualenv أقدم وأغنى. Conda حل شامل (Python + حزم غير Python) شائع في علوم البيانات، أثقل وأقل ملاءمة لمشاريع الويب.

requirements.txt أم pyproject.toml؟
يجب حفظ ملف التبعيات. requirements.txt بسيط ومتوافق. pyproject.toml مع Poetry أو uv أكثر تعبيرًا وحتمي. لمشروع جديد، pyproject.toml مع uv هو الخيار الحديث.

تثبيت Python 3 وإعداد بيئة التطوير