| PIP-INSTALL(1) | pip | PIP-INSTALL(1) |
نام (NAME)
pip-install - توضیحات دستور pip install
توضیحات (DESCRIPTION)
نصب بسته‌ها از:
- PyPI (و سایر نمایه‌ها) با استفاده از مشخص‌کننده‌های نیازمندی (requirement specifiers).
- نشانی‌های وب (URL) پروژه‌های سامانه کنترل نسخه (VCS).
- دایرکتوری‌های محلی پروژه.
- آرشیوهای سورس محلی یا دوردست (remote).
همچنین pip از نصب از طریق "فایل‌های نیازمندی‌ها" (requirements files) پشتیبانی می‌کند، که روشی آسان برای تعیین کل محیط جهت نصب فراهم می‌سازند.
نحوه استفاده (USAGE)
python -m pip install [options] <requirement specifier> [package-index-options] ... python -m pip install [options] -r <requirements file> [package-index-options] ... python -m pip install [options] [-e] <vcs project url> ... python -m pip install [options] [-e] <local project path> ... python -m pip install [options] <archive url/path> ...
گزینه‌ها (OPTIONS)
- -r, --requirement <file>
- نصب از فایل
نیازمندی‌های
داده‌شده.
فایل یا
نشانی وب (URL)
می‌تواند
در قالب requirements.txt
مربوط به pip
یا در قالب
pylock.toml باشد.
پشتیبانی
از pylock.toml
آزمایشی
است. این
گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_REQUIREMENT)
- -c, --constraint <file>
- محدود کردن
نسخه‌ها با
استفاده از
فایل قیود
(constraints file)
داده‌شده.
این گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_CONSTRAINT)
- --build-constraint <file>
- محدود کردن
وابستگی‌های
ساخت با
استفاده از
فایل قیود
داده‌شده.
این گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_BUILD_CONSTRAINT)
- --requirements-from-script <file>
- نصب
وابستگی‌های
فایل
اسکریپت
داده‌شده،
طبق
متادیتای
درون‌برنامه‌ای
تعریف‌شده
در PEP 723.
(متغیر محیطی: PIP_REQUIREMENTS_FROM_SCRIPT)
- --no-deps
- وابستگی‌های
بسته نصب
نشوند.
(متغیر محیطی: PIP_NO_DEPS، PIP_NO_DEPENDENCIES)
- --only-deps
- تنها
وابستگی‌های
نیازمندی‌های
ارائه‌شده
در نظر
گرفته
شوند، نه
خود
نیازمندی‌ها.
نمی‌توان
آن را همراه
با --no-deps، --group، --requirement
یا --requirements-from-script
استفاده
کرد. هیچ‌یک
از
نیازمندی‌های
ارائه‌شده
توسط کاربر
پردازش
نخواهند
شد، حتی اگر
وابستگی
نیازمندی‌های
دیگری
باشند که
توسط کاربر
ارائه
شده‌اند.
(متغیر محیطی: PIP_ONLY_DEPS، PIP_ONLY_DEPENDENCIES)
- -e, --editable <path/url>
- نصب یک
پروژه در
حالت قابل
ویرایش
(یعنی «حالت
توسعه» در
setuptools) از یک
مسیر محلی
پروژه یا یک
نشانی
اینترنتی
سامانه
کنترل نسخه
(VCS).
(متغیر محیطی: PIP_EDITABLE)
- --dry-run
- در عمل چیزی
نصب نشود،
تنها
مواردی که
قرار است
نصب شوند
نمایش داده
شوند.
می‌تواند
همراه با
--ignore-installed برای حل
نیازمندی‌ها
(resolve) استفاده
شود.
(متغیر محیطی: PIP_DRY_RUN)
- -t, --target <dir>
- نصب
بسته‌ها در
<dir>. به‌طور
پیش‌فرض
فایل‌ها/پوشه‌های
موجود در <dir>
جایگزین
نخواهند شد.
برای
جایگزینی
بسته‌های
موجود در <dir>
با
نسخه‌های
جدید از --upgrade
استفاده
کنید.
(متغیر محیطی: PIP_TARGET)
- --platform <platform>
- تنها از
wheelهای
سازگار با
<platform> استفاده
شود. مقدار
پیش‌فرض،
پلتفرم
سیستم در
حال اجرا
است. برای
مشخص کردن
چندین
پلتفرم
پشتیبانی‌شده
توسط مفسر
مقصد، این
گزینه را
چندین بار
استفاده
کنید.
(متغیر محیطی: PIP_PLATFORM)
- --python-version <python_version>
- نسخه مفسر
پایتون جهت
استفاده
برای
بررسی‌های
سازگاری wheel و
"Requires-Python". مقدار
پیش‌فرض،
نسخه‌ای
است که از
مفسر در حال
اجرا به دست
می‌آید.
نسخه را
می‌توان با
حداکثر سه
عدد صحیح
جداشده با
نقطه مشخص
کرد (مثلاً
"3" برای 3.0.0،
"3.7" برای 3.7.0 یا
"3.7.3"). نسخه
اصلی-فرعی
(major-minor) را
می‌توان
به‌صورت یک
رشته بدون
نقطه نیز
وارد کرد
(مثلاً "37"
برای 3.7.0).
(متغیر محیطی: PIP_PYTHON_VERSION)
- --implementation <implementation>
- تنها از
wheelهای
سازگار با
پیاده‌سازی
پایتون <implementation>
استفاده
شود، مانند
'pp'، 'jy'، 'cp' یا 'ip'. در
صورت عدم
تعیین، از
پیاده‌سازی
مفسر فعلی
استفاده
می‌شود.
برای اجبار
به استفاده
از wheelهای
مستقل از
پیاده‌سازی،
از 'py'
استفاده
کنید.
(متغیر محیطی: PIP_IMPLEMENTATION)
- --abi <abi>
- تنها از
wheelهای
سازگار با ABI
پایتون <abi>
استفاده
شود، مانند
'pypy_41'. در صورت
عدم تعیین،
از برچسب ABI
مفسر فعلی
استفاده
می‌شود.
برای مشخص
کردن چندین
ABI
پشتیبانی‌شده
توسط مفسر
مقصد، این
گزینه را
چندین بار
استفاده
کنید.
به‌طور کلی
هنگام
استفاده از
این گزینه،
لازم است
--implementation، --platform و --python-version
را مشخص
کنید.
(متغیر محیطی: PIP_ABI)
- --user
- نصب در
دایرکتوری
نصب کاربری
پایتون
برای
پلتفرم شما.
معمولاً ~/.local/
یا %APPDATA%Python در
ویندوز.
(برای
جزئیات
کامل،
مستندات
پایتون
مربوط به site.USER_BASE
را ببینید.)
(متغیر محیطی: PIP_USER)
- --root <dir>
- نصب
همه‌چیز
به‌صورت
نسبی نسبت
به این
دایرکتوری
ریشه
جایگزین.
(متغیر محیطی: PIP_ROOT)
- --prefix <dir>
- پیشوند نصب
که در آن
پوشه‌های
سطح بالا
مانند lib، bin و
غیره قرار
می‌گیرند.
توجه داشته
باشید که
نصب حاصل
ممکن است
شامل
اسکریپت‌ها
و منابع
دیگری باشد
که به مفسر
پایتون
مربوط به pip
ارجاع
می‌دهند،
نه مفسر --prefix.
همچنین اگر
قصد دارید
بسته‌ها را
در محیط
دیگری
(احتمالاً
بدون pip) نصب
کنید،
گزینه --python را
ببینید.
(متغیر محیطی: PIP_PREFIX)
(متغیر محیطی: PIP_SRC، PIP_SOURCE، PIP_SOURCE_DIR، PIP_SOURCE_DIRECTORY)
- -U, --upgrade
- ارتقای
تمام
بسته‌های
مشخص‌شده
به
جدیدترین
نسخهٔ
موجود.
مدیریت
وابستگی‌ها
به upgrade-strategy
استفاده‌شده
بستگی دارد.
(متغیر محیطی: PIP_UPGRADE)
- --upgrade-strategy <upgrade_strategy>
- تعیین
چگونگی
مدیریت
ارتقای
وابستگی‌ها
[پیش‌فرض:
only-if-needed]. با "eager" -
وابستگی‌ها
بدون در نظر
گرفتن
اینکه
نسخهٔ
نصب‌شدهٔ
فعلی
نیازمندی‌های
بسته(های)
ارتقایافته
را برآورده
می‌کند یا
خیر، ارتقا
می‌یابند.
با "only-if-needed" -
وابستگی‌ها
فقط زمانی
ارتقا
می‌یابند
که
نیازمندی‌های
بسته(های)
ارتقایافته
را برآورده
نکنند.
(متغیر محیطی: PIP_UPGRADE_STRATEGY)
- --force-reinstall
- نصب مجدد
تمام
بسته‌ها
حتی اگر در
حال حاضر
به‌روز
باشند.
(متغیر محیطی: PIP_FORCE_REINSTALL)
- -I, --ignore-installed
- نادیده
گرفتن
بسته‌های
نصب‌شده و
رونویسی
آن‌ها. این
کار در
صورتی که
بستهٔ
موجود
نسخه‌ای
متفاوت
داشته باشد
یا با مدیر
بستهٔ
متفاوتی
نصب شده
باشد،
می‌تواند
به خرابی
سیستم شما
منجر شود!
(متغیر محیطی: PIP_IGNORE_INSTALLED)
- --ignore-requires-python
- نادیده
گرفتن
اطلاعات
مربوط به Requires-Python.
(متغیر محیطی: PIP_IGNORE_REQUIRES_PYTHON)
- --no-build-isolation
- غیرفعال
کردن
ایزولاسیون
هنگام ساخت
یک توزیع
مبدأ (source distribution)
مدرن. در
صورت
استفاده از
این گزینه،
وابستگی‌های
ساخت
تعیین‌شده
در PEP 518 باید از
قبل نصب شده
باشند.
(متغیر محیطی: PIP_NO_BUILD_ISOLATION)
- --check-build-dependencies
- بررسی
وابستگی‌های
ساخت.
(متغیر محیطی: PIP_CHECK_BUILD_DEPENDENCIES)
- --break-system-packages
- اجازه دادن
به pip برای
اعمال
تغییرات در
یک پایتون
با نصب EXTERNALLY-MANAGED
(متغیر محیطی: PIP_BREAK_SYSTEM_PACKAGES)
- -C, --config-settings <settings>
- تنظیمات
پیکربندی
برای ارسال
به بک‌اند
ساخت (build backend).
تنظیمات به
قالب KEY=VALUE
هستند. برای
ارسال چند
کلید به
بک‌اند،
گزینهٔ --config-settings
را چندین
بار به کار
ببرید.
(متغیر محیطی: PIP_CONFIG_SETTINGS)
- --compile
- کامپایل
کردن
فایل‌های
مبدأ
پایتون به
بایت‌کد (bytecode)
(متغیر محیطی: PIP_COMPILE)
- --no-compile
- کامپایل
نکردن
فایل‌های
مبدأ
پایتون به
بایت‌کد
(متغیر محیطی: PIP_NO_COMPILE)
- --no-warn-script-location
- عدم نمایش
هشدار
هنگام نصب
اسکریپت‌ها
در خارج از PATH
(متغیر محیطی: PIP_NO_WARN_SCRIPT_LOCATION)
- --no-warn-conflicts
- عدم نمایش
هشدار
دربارهٔ
وابستگی‌های
شکسته و
ناسازگار
(متغیر محیطی: PIP_NO_WARN_CONFLICTS)
- --require-hashes
- الزام هش
جهت تطبیق
هر
نیازمندی
در برابر
آن، برای
نصب‌های
تکرارپذیر.
زمانی که هر
بسته‌ای در
یک فایل requirements
دارای یک
گزینهٔ --hash
باشد، این
گزینه
به‌طور
ضمنی فعال
می‌شود.
(متغیر محیطی: PIP_REQUIRE_HASHES)
- --no-require-hashes
- عدم
فعال‌سازی
خودکار --require-hashes
در هنگام
مواجهه با
یک
نیازمندی
دارای هش.
(متغیر محیطی: PIP_NO_REQUIRE_HASHES)
- --progress-bar <progress_bar>
- تعیین
اینکه آیا
از نوار
پیشرفت
استفاده
شود یا خیر.
در حالت 'auto'،
گزینهٔ --quiet
تمام
نوارهای
پیشرفت را
غیرفعال
می‌کند. [auto، on،
off، raw]
(پیش‌فرض: auto)
(متغیر محیطی: PIP_PROGRESS_BAR)
- --root-user-action <root_user_action>
- اقدام لازم
در صورتی که
pip با کاربر
ریشه (root) اجرا
شود [warn، ignore]
(پیش‌فرض: warn)
(متغیر محیطی: PIP_ROOT_USER_ACTION)
- --report <file>
- ایجاد یک
فایل JSON که
کارهای
انجام‌شده
توسط pip برای
نصب
نیازمندی‌های
دریافت‌شده
را شرح
می‌دهد.
می‌تواند
در ترکیب با
--dry-run و --ignore-installed برای
برطرف‌سازی
('resolve')
نیازمندی‌ها
به کار رود.
هنگامی که -
به عنوان
نام فایل
داده شود،
در خروجی
استاندارد
(stdout) می‌نویسد.
در صورت
نوشتن در stdout،
لطفاً آن را
با گزینهٔ --quiet
ترکیب کنید
تا از مخلوط
شدن
لاگ‌های
خروجی pip با
خروجی JSON
جلوگیری
شود.
(متغیر محیطی: PIP_REPORT)
- --group <[path:]group>
- نصب یک گروه
وابستگی
(dependency-group)
مشخص‌شده
از یک فایل
"pyproject.toml". در
صورت
ارائهٔ
مسیر، نام
فایل حتماً
باید "pyproject.toml"
باشد. حالت
پیش‌فرض
استفاده از
"pyproject.toml" در
دایرکتوری
جاری است.
(متغیر محیطی: PIP_GROUP)
- --no-clean
- عدم
پاک‌سازی
دایرکتوری‌های
ساخت.
(متغیر محیطی: PIP_NO_CLEAN) توسعه‌دهندگان pip
کپی‌رایت و تکثیر (COPYRIGHT)
توسعه‌دهندگان pip
| August 5, 2026 | 26.2 |