ابزار uv چیست؛ مدیریت سریع پکیج‌های پایتون با یک ابزار واحد


uv چیست و چرا همه از آن حرف می‌زنند؟ #

اگر با پایتون کار کرده باشید، حتماً با پراکندگی ابزارها درگیر شده‌اید: pip برای نصب، venv برای محیط مجازی، pyenv برای نسخه‌ها، pipx برای ابزارهای CLI و poetry برای مدیریت پروژه. uv ابزار متن‌بازی از تیم Astral است که همهٔ این‌ها را با یک باینری واحد و سرعتی چشمگیر جایگزین می‌کند؛ همان تیمی که linter مشهور ruff را ساخته است.

ℹ️ اطلاعات: uv با زبان Rust نوشته شده و طبق مستندات رسمی، جایگزین واحدی برای pip، pip-tools، pipx، poetry، pyenv، twine و virtualenv است.

نصب: یک دستور و تمام #

bash
# نصب با نصب‌کنندهٔ مستقل (macOS / Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh

# یا از طریق pip / pipx
pip install uv

اگر روی ویندوز هستید، نصب‌کنندهٔ PowerShell در مستندات نصب معرفی شده است.

یک پروژهٔ کامل با uv: از صفر تا اجرا #

bash
# ساخت پروژهٔ جدید
uv init myproject
cd myproject

# افزودن وابستگی‌ها (همزمان می‌سازد venv و نصب می‌کند)
uv add requests

# اجرا با محیط پروژه، بدون فعال‌سازی دستی venv
uv run python main.py

چیزی که پشت‌صحنه اتفاق می‌افتد: uv یک فایل pyproject.toml می‌سازد، وابستگی‌ها را رزولو می‌کند، نسخه‌های دقیق را در فایل قفل uv.lock ثبت می‌کند و محیط مجازی را خودکار می‌سازد. بعد از این، هم‌تیمی‌های شما با یک uv sync دقیقاً همان محیط شما را خواهند داشت — کاملاً تکرارپذیر.

مدیریت خود نسخه‌های پایتون #

یکی از کاربردی‌ترین قابلیت‌ها، حذف نیاز به pyenv است:

bash
# نصب نسخهٔ مشخص پایتون
uv python install 3.14

# ساخت venv با نسخهٔ دلخواه
uv venv --python 3.12

uv نسخهٔ مناسب را دانلود و مدیریت می‌کند و پروژه‌ها می‌توانند نسخهٔ پایتون موردنیاز خود را در pyproject.toml تعریف کنند تا به‌صورت خودکار فراهم شود.

رابط سازگار با pip: مهاجرت بدون دردسر #

اگر پروژهٔ فعلی شما با requirements.txt کار می‌کند، لازم نیست همه‌چیز را یک‌شبه عوض کنید؛ uv یک رابط pip تقریباً سازگار دارد:

bash
uv pip install -r requirements.txt   # مانند pip، اما سریع‌تر
uv pip freeze                        # لیست پکیج‌های محیط جاری

همچنین برای ابزارهای CLI مثل ruff یا httpie، دستور uv tool install جایگزین pipx می‌شود و ابزارها را در محیط‌های ایزوله نگه می‌دارد.

💡 نکته: کل کش پکیج‌ها در uv سراسری و مبتنی بر content-addressable است؛ یعنی نصب مجدد یک نسخهٔ همان پکیج در پروژهٔ دیگر تقریباً آنی است و فضای دیسک هم هدر نمی‌رود.

uv در مقابل pip: چرا این‌قدر سریع‌تر است؟ #

سه دلیل اصلی سرعت uv:

  • نوشته‌شدن با Rust و استفادهٔ موازی از منابع سیستم هنگام دانلود و رزولوشن وابستگی‌ها
  • کش سراسری هوشمند که دانلودهای تکراری را حذف می‌کند
  • resolver وابستگی مدرن با فایل قفل cross-platform

نتیجهٔ عملی برای تیم‌ها: نصب‌های چند‌دقیقه‌ای CI به چند‌ثانیه‌ای تبدیل می‌شود؛ برای همین مستندات رسمی uv یک راهنمای ادغام با GitHub Actions هم دارد.

جمع‌بندی #

uv در حال تبدیل‌شدن به ابزار پیش‌فرض مدیریت پکیج پایتون است: یک دستور نصب، جایگزینی کامل pip/venv/pyenv/pipx، فایل قفل تکرارپذیر و سازگاری با ابزارهای فعلی. اگر CI شما کند است یا مدیریت محیط‌ها وقت می‌گیرد، همین امروز uv را امتحان کنید؛ و برای اتصال آن به Pipeline خودکارسازی، راهنمای سریع CI/CD با GitHub Actions ما را از دست ندهید.

این پست چطور بود؟

پست‌های مرتبط