PIP-CONFIG(1) pip PIP-CONFIG(1)

pip-config - مدیریت و تنظیم پیکربندی pip

مدیریت پیکربندی محلی و سراسری.

زیردستورها:

  • list: فهرست کردن پیکربندی فعال (یا از فایل مشخص‌شده)
  • edit: ویرایش فایل پیکربندی در یک ویرایشگر
  • get: دریافت مقدار مرتبط با command.option
  • set: مقداردهی به command.option=value
  • unset: حذف مقدار مرتبط با command.option
  • debug: فهرست کردن فایل‌های پیکربندی و مقادیر تعریف‌شده ذیل آن‌ها

کلیدهای پیکربندی باید نام دستور و گزینه باشند که با نقطه از هم جدا شده‌اند، همراه با پیشوند ویژه "global" که بر تمام دستورها اثر می‌گذارد. برای مثال، "pip config set global.index-url https://example.org" آدرس index url را برای تمام دستورها پیکربندی می‌کند، اما "pip config set download.timeout 10" یک مهلت زمانی ۱۰ ثانیه‌ای را فقط برای دستورهای "pip download" تنظیم می‌کند.

اگر هیچ‌کدام از گزینه‌های --user، --global و --site داده نشوند، در صورت فعال بودن یک محیط مجازی و وجود داشتن فایل، از فایل پیکربندی آن محیط مجازی استفاده می‌شود. در غیر این صورت، به‌طور پیش‌فرض تمام تغییرات روی فایل کاربر اعمال خواهد شد.

python -m pip config [<file-option>] list
python -m pip config [<file-option>] [--editor <editor-path>] edit
python -m pip config [<file-option>] get command.option
python -m pip config [<file-option>] set command.option value
python -m pip config [<file-option>] unset command.option
python -m pip config [<file-option>] debug

ویرایشگری که برای ویرایش فایل به کار می‌رود. در صورت مشخص نشدن، از متغیرهای محیطی VISUAL یا EDITOR استفاده می‌شود.

(متغیر محیطی: PIP_EDITOR)

تنها استفاده از فایل پیکربندی سراسری کل سیستم

(متغیر محیطی: PIP_GLOBAL)

تنها استفاده از فایل پیکربندی کاربر

(متغیر محیطی: PIP_USER)

تنها استفاده از فایل پیکربندی محیط جاری

(متغیر محیطی: PIP_SITE)

توسعه‌دهندگان pip

توسعه‌دهندگان pip

August 5, 2026 26.2