ابزار uv چیست؛ مدیریت سریع پکیجهای پایتون با یک ابزار واحد
uv چیست و چرا همه از آن حرف میزنند؟ #
اگر با پایتون کار کرده باشید، حتماً با پراکندگی ابزارها درگیر شدهاید: pip برای نصب، venv برای محیط مجازی، pyenv برای نسخهها، pipx برای ابزارهای CLI و poetry برای مدیریت پروژه. uv ابزار متنبازی از تیم Astral است که همهٔ اینها را با یک باینری واحد و سرعتی چشمگیر جایگزین میکند؛ همان تیمی که linter مشهور ruff را ساخته است.
ℹ️ اطلاعات: uv با زبان Rust نوشته شده و طبق مستندات رسمی، جایگزین واحدی برای
pip،pip-tools،pipx،poetry،pyenv،twineوvirtualenvاست.
نصب: یک دستور و تمام #
# نصب با نصبکنندهٔ مستقل (macOS / Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh
# یا از طریق pip / pipx
pip install uv
اگر روی ویندوز هستید، نصبکنندهٔ PowerShell در مستندات نصب معرفی شده است.
یک پروژهٔ کامل با uv: از صفر تا اجرا #
# ساخت پروژهٔ جدید
uv init myproject
cd myproject
# افزودن وابستگیها (همزمان میسازد venv و نصب میکند)
uv add requests
# اجرا با محیط پروژه، بدون فعالسازی دستی venv
uv run python main.py
چیزی که پشتصحنه اتفاق میافتد: uv یک فایل pyproject.toml میسازد، وابستگیها را رزولو میکند، نسخههای دقیق را در فایل قفل uv.lock ثبت میکند و محیط مجازی را خودکار میسازد. بعد از این، همتیمیهای شما با یک uv sync دقیقاً همان محیط شما را خواهند داشت — کاملاً تکرارپذیر.
مدیریت خود نسخههای پایتون #
یکی از کاربردیترین قابلیتها، حذف نیاز به pyenv است:
# نصب نسخهٔ مشخص پایتون
uv python install 3.14
# ساخت venv با نسخهٔ دلخواه
uv venv --python 3.12
uv نسخهٔ مناسب را دانلود و مدیریت میکند و پروژهها میتوانند نسخهٔ پایتون موردنیاز خود را در pyproject.toml تعریف کنند تا بهصورت خودکار فراهم شود.
رابط سازگار با pip: مهاجرت بدون دردسر #
اگر پروژهٔ فعلی شما با requirements.txt کار میکند، لازم نیست همهچیز را یکشبه عوض کنید؛ uv یک رابط pip تقریباً سازگار دارد:
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 ما را از دست ندهید.