البداية السريعة مع Python uv: ابنِ أول مشروع

يسلك هذا الدليل أقصر طريق للحصول على مشروع Python عامل — أول بيئة قابلة للاستخدام مع uv.

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

• uv مثبّت (انظر أمر التثبيت في النظرة العامة)
• المحطة الطرفية تستطيع تشغيل أمر uv

مثال بسيط: إنشاء أول مشروع

الخطوة 1: التحقق من تثبيت uv

uv --version

إذا ظهر رقم إصدار، أنت جاهز. إذا لم يظهر، شغّل سكريبت التثبيت مجدداً وأعد تشغيل محطتك.

الخطوة 2: تهيئة المشروع

uv init my-app
cd my-app

ينشئ uv تلقائياً pyproject.toml و.python-version وmain.py وREADME.md. الهيكل يبدو تقريباً كالتالي:

my-app/
├── .gitignore
├── .python-version
├── README.md
├── main.py
└── pyproject.toml

الخطوة 3: تشغيل البرنامج الافتراضي

uv run main.py

سترى Hello from my-app! — تهانينا، أول مشروع لك حي!

الخطوة 4: إضافة تبعية وتشغيلها

uv add requests

ثم حدّث main.py لتجربتها:

import requests
r = requests.get("https://httpbin.org/get")
print(r.status_code)

شغّله:

uv run main.py

إذا رأيت 200، التبعية ثُبِّتت بشكل صحيح في البيئة الافتراضية — بدون pip install يدوي، بدون source .venv/bin/activate. ذلك الشعور بالسهولة هو فرحة uv.

استكشاف الأخطاء الشائعة

الخطوات التالية

بمجرد تشغيل المشروع، من الجيد فهم ما تفعله pyproject.toml وuv.lock. المقالة التالية تغطي هذه المفاهيم الجوهرية:
👉 المفاهيم الجوهرية