.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "PIP-INSTALL" "1" "Aug 05, 2026" "26.2" "pip" .SH "نام (NAME)" pip-install \- توضیحات دستور pip install .SH "توضیحات (DESCRIPTION)" .sp نصب بسته‌ها از: .INDENT 0.0 .IP \(bu 2 PyPI (و سایر نمایه‌ها) با استفاده از مشخص‌کننده‌های نیازمندی (requirement specifiers). .IP \(bu 2 نشانی‌های وب (URL) پروژه‌های سامانه کنترل نسخه (VCS). .IP \(bu 2 دایرکتوری‌های محلی پروژه. .IP \(bu 2 آرشیوهای سورس محلی یا دوردست (remote). .UNINDENT .sp همچنین pip از نصب از طریق \(dqفایل‌های نیازمندی‌ها\(dq (requirements files) پشتیبانی می‌کند، که روشی آسان برای تعیین کل محیط جهت نصب فراهم می‌سازند. .SH "نحوه استفاده (USAGE)" .INDENT 0.0 .INDENT 3.5 .sp .EX python \-m pip install [options] [package\-index\-options] ... python \-m pip install [options] \-r [package\-index\-options] ... python \-m pip install [options] [\-e] ... python \-m pip install [options] [\-e] ... python \-m pip install [options] ... .EE .UNINDENT .UNINDENT .SH "گزینه‌ها (OPTIONS)" .sp .INDENT 0.0 .TP .B \-r, \-\-requirement نصب از فایل نیازمندی‌های داده‌شده. فایل یا نشانی وب (URL) می‌تواند در قالب requirements.txt مربوط به pip یا در قالب pylock.toml باشد. پشتیبانی از pylock.toml آزمایشی است. این گزینه می‌تواند چندین بار استفاده شود. .sp (متغیر محیطی: \fBPIP_REQUIREMENT\fP) .UNINDENT .INDENT 0.0 .TP .B \-c, \-\-constraint محدود کردن نسخه‌ها با استفاده از فایل قیود (constraints file) داده‌شده. این گزینه می‌تواند چندین بار استفاده شود. .sp (متغیر محیطی: \fBPIP_CONSTRAINT\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-build\-constraint محدود کردن وابستگی‌های ساخت با استفاده از فایل قیود داده‌شده. این گزینه می‌تواند چندین بار استفاده شود. .sp (متغیر محیطی: \fBPIP_BUILD_CONSTRAINT\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-requirements\-from\-script نصب وابستگی‌های فایل اسکریپت داده‌شده، طبق متادیتای درون‌برنامه‌ای تعریف‌شده در PEP 723. .sp (متغیر محیطی: \fBPIP_REQUIREMENTS_FROM_SCRIPT\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-no\-deps وابستگی‌های بسته نصب نشوند. .sp (متغیر محیطی: \fBPIP_NO_DEPS\fP، \fBPIP_NO_DEPENDENCIES\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-only\-deps تنها وابستگی‌های نیازمندی‌های ارائه‌شده در نظر گرفته شوند، نه خود نیازمندی‌ها. نمی‌توان آن را همراه با \-\-no\-deps، \-\-group، \-\-requirement یا \-\-requirements\-from\-script استفاده کرد. هیچ‌یک از نیازمندی‌های ارائه‌شده توسط کاربر پردازش نخواهند شد، حتی اگر وابستگی نیازمندی‌های دیگری باشند که توسط کاربر ارائه شده‌اند. .sp (متغیر محیطی: \fBPIP_ONLY_DEPS\fP، \fBPIP_ONLY_DEPENDENCIES\fP) .UNINDENT .INDENT 0.0 .TP .B \-e, \-\-editable نصب یک پروژه در حالت قابل ویرایش (یعنی «حالت توسعه» در setuptools) از یک مسیر محلی پروژه یا یک نشانی اینترنتی سامانه کنترل نسخه (VCS). .sp (متغیر محیطی: \fBPIP_EDITABLE\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-dry\-run در عمل چیزی نصب نشود، تنها مواردی که قرار است نصب شوند نمایش داده شوند. می‌تواند همراه با \-\-ignore\-installed برای حل نیازمندی‌ها (resolve) استفاده شود. .sp (متغیر محیطی: \fBPIP_DRY_RUN\fP) .UNINDENT .INDENT 0.0 .TP .B \-t, \-\-target نصب بسته‌ها در . به‌طور پیش‌فرض فایل‌ها/پوشه‌های موجود در جایگزین نخواهند شد. برای جایگزینی بسته‌های موجود در با نسخه‌های جدید از \-\-upgrade استفاده کنید. .sp (متغیر محیطی: \fBPIP_TARGET\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-platform تنها از wheelهای سازگار با استفاده شود. مقدار پیش‌فرض، پلتفرم سیستم در حال اجرا است. برای مشخص کردن چندین پلتفرم پشتیبانی‌شده توسط مفسر مقصد، این گزینه را چندین بار استفاده کنید. .sp (متغیر محیطی: \fBPIP_PLATFORM\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-python\-version نسخه مفسر پایتون جهت استفاده برای بررسی‌های سازگاری wheel و \(dqRequires\-Python\(dq. مقدار پیش‌فرض، نسخه‌ای است که از مفسر در حال اجرا به دست می‌آید. نسخه را می‌توان با حداکثر سه عدد صحیح جداشده با نقطه مشخص کرد (مثلاً \(dq3\(dq برای 3.0.0، \(dq3.7\(dq برای 3.7.0 یا \(dq3.7.3\(dq). نسخه اصلی\-فرعی (major\-minor) را می‌توان به‌صورت یک رشته بدون نقطه نیز وارد کرد (مثلاً \(dq37\(dq برای 3.7.0). .sp (متغیر محیطی: \fBPIP_PYTHON_VERSION\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-implementation تنها از wheelهای سازگار با پیاده‌سازی پایتون استفاده شود، مانند \(aqpp\(aq، \(aqjy\(aq، \(aqcp\(aq یا \(aqip\(aq. در صورت عدم تعیین، از پیاده‌سازی مفسر فعلی استفاده می‌شود. برای اجبار به استفاده از wheelهای مستقل از پیاده‌سازی، از \(aqpy\(aq استفاده کنید. .sp (متغیر محیطی: \fBPIP_IMPLEMENTATION\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-abi تنها از wheelهای سازگار با ABI پایتون استفاده شود، مانند \(aqpypy_41\(aq. در صورت عدم تعیین، از برچسب ABI مفسر فعلی استفاده می‌شود. برای مشخص کردن چندین ABI پشتیبانی‌شده توسط مفسر مقصد، این گزینه را چندین بار استفاده کنید. به‌طور کلی هنگام استفاده از این گزینه، لازم است \-\-implementation، \-\-platform و \-\-python\-version را مشخص کنید. .sp (متغیر محیطی: \fBPIP_ABI\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-user نصب در دایرکتوری نصب کاربری پایتون برای پلتفرم شما. معمولاً ~/.local/ یا %APPDATA%Python در ویندوز. (برای جزئیات کامل، مستندات پایتون مربوط به site.USER_BASE را ببینید.) .sp (متغیر محیطی: \fBPIP_USER\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-root نصب همه‌چیز به‌صورت نسبی نسبت به این دایرکتوری ریشه جایگزین. .sp (متغیر محیطی: \fBPIP_ROOT\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-prefix پیشوند نصب که در آن پوشه‌های سطح بالا مانند lib، bin و غیره قرار می‌گیرند. توجه داشته باشید که نصب حاصل ممکن است شامل اسکریپت‌ها و منابع دیگری باشد که به مفسر پایتون مربوط به pip ارجاع می‌دهند، نه مفسر \fB\-\-prefix\fP\&. همچنین اگر قصد دارید بسته‌ها را در محیط دیگری (احتمالاً بدون pip) نصب کنید، گزینه \fB\-\-python\fP را ببینید. .sp (متغیر محیطی: \fBPIP_PREFIX\fP) .UNINDENT .INDENT 0.0.TP .B \-\-src دایرکتوری برای واکشی پروژه‌های قابل ویرایش (editable). مقدار پیش‌فرض در virtualenv برابر با \(dq/src\(dq است. مقدار پیش‌فرض برای نصب‌های سراسری \(dq/src\(dq است. .sp (متغیر محیطی: \fBPIP_SRC\fP، \fBPIP_SOURCE\fP، \fBPIP_SOURCE_DIR\fP، \fBPIP_SOURCE_DIRECTORY\fP) .UNINDENT .INDENT 0.0 .TP .B \-U, \-\-upgrade ارتقای تمام بسته‌های مشخص‌شده به جدیدترین نسخهٔ موجود. مدیریت وابستگی‌ها به upgrade\-strategy استفاده‌شده بستگی دارد. .sp (متغیر محیطی: \fBPIP_UPGRADE\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-upgrade\-strategy تعیین چگونگی مدیریت ارتقای وابستگی‌ها [پیش‌فرض: only\-if\-needed]. با \(dqeager\(dq \- وابستگی‌ها بدون در نظر گرفتن اینکه نسخهٔ نصب‌شدهٔ فعلی نیازمندی‌های بسته(های) ارتقایافته را برآورده می‌کند یا خیر، ارتقا می‌یابند. با \(dqonly\-if\-needed\(dq \- وابستگی‌ها فقط زمانی ارتقا می‌یابند که نیازمندی‌های بسته(های) ارتقایافته را برآورده نکنند. .sp (متغیر محیطی: \fBPIP_UPGRADE_STRATEGY\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-force\-reinstall نصب مجدد تمام بسته‌ها حتی اگر در حال حاضر به‌روز باشند. .sp (متغیر محیطی: \fBPIP_FORCE_REINSTALL\fP) .UNINDENT .INDENT 0.0 .TP .B \-I, \-\-ignore\-installed نادیده گرفتن بسته‌های نصب‌شده و رونویسی آن‌ها. این کار در صورتی که بستهٔ موجود نسخه‌ای متفاوت داشته باشد یا با مدیر بستهٔ متفاوتی نصب شده باشد، می‌تواند به خرابی سیستم شما منجر شود! .sp (متغیر محیطی: \fBPIP_IGNORE_INSTALLED\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-ignore\-requires\-python نادیده گرفتن اطلاعات مربوط به Requires\-Python. .sp (متغیر محیطی: \fBPIP_IGNORE_REQUIRES_PYTHON\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-no\-build\-isolation غیرفعال کردن ایزولاسیون هنگام ساخت یک توزیع مبدأ (source distribution) مدرن. در صورت استفاده از این گزینه، وابستگی‌های ساخت تعیین‌شده در PEP 518 باید از قبل نصب شده باشند. .sp (متغیر محیطی: \fBPIP_NO_BUILD_ISOLATION\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-check\-build\-dependencies بررسی وابستگی‌های ساخت. .sp (متغیر محیطی: \fBPIP_CHECK_BUILD_DEPENDENCIES\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-break\-system\-packages اجازه دادن به pip برای اعمال تغییرات در یک پایتون با نصب EXTERNALLY\-MANAGED .sp (متغیر محیطی: \fBPIP_BREAK_SYSTEM_PACKAGES\fP) .UNINDENT .INDENT 0.0 .TP .B \-C, \-\-config\-settings تنظیمات پیکربندی برای ارسال به بک‌اند ساخت (build backend). تنظیمات به قالب KEY=VALUE هستند. برای ارسال چند کلید به بک‌اند، گزینهٔ \-\-config\-settings را چندین بار به کار ببرید. .sp (متغیر محیطی: \fBPIP_CONFIG_SETTINGS\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-compile کامپایل کردن فایل‌های مبدأ پایتون به بایت‌کد (bytecode) .sp (متغیر محیطی: \fBPIP_COMPILE\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-no\-compile کامپایل نکردن فایل‌های مبدأ پایتون به بایت‌کد .sp (متغیر محیطی: \fBPIP_NO_COMPILE\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-no\-warn\-script\-location عدم نمایش هشدار هنگام نصب اسکریپت‌ها در خارج از PATH .sp (متغیر محیطی: \fBPIP_NO_WARN_SCRIPT_LOCATION\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-no\-warn\-conflicts عدم نمایش هشدار دربارهٔ وابستگی‌های شکسته و ناسازگار .sp (متغیر محیطی: \fBPIP_NO_WARN_CONFLICTS\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-require\-hashes الزام هش جهت تطبیق هر نیازمندی در برابر آن، برای نصب‌های تکرارپذیر. زمانی که هر بسته‌ای در یک فایل requirements دارای یک گزینهٔ \-\-hash باشد، این گزینه به‌طور ضمنی فعال می‌شود. .sp (متغیر محیطی: \fBPIP_REQUIRE_HASHES\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-no\-require\-hashes عدم فعال‌سازی خودکار \-\-require\-hashes در هنگام مواجهه با یک نیازمندی دارای هش. .sp (متغیر محیطی: \fBPIP_NO_REQUIRE_HASHES\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-progress\-bar تعیین اینکه آیا از نوار پیشرفت استفاده شود یا خیر. در حالت \(aqauto\(aq، گزینهٔ \-\-quiet تمام نوارهای پیشرفت را غیرفعال می‌کند. [auto، on، off، raw] (پیش‌فرض: auto) .sp (متغیر محیطی: \fBPIP_PROGRESS_BAR\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-root\-user\-action اقدام لازم در صورتی که pip با کاربر ریشه (root) اجرا شود [warn، ignore] (پیش‌فرض: warn) .sp (متغیر محیطی: \fBPIP_ROOT_USER_ACTION\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-report ایجاد یک فایل JSON که کارهای انجام‌شده توسط pip برای نصب نیازمندی‌های دریافت‌شده را شرح می‌دهد. می‌تواند در ترکیب با \-\-dry\-run و \-\-ignore\-installed برای برطرف‌سازی (\(aqresolve\(aq) نیازمندی‌ها به کار رود. هنگامی که \- به عنوان نام فایل داده شود، در خروجی استاندارد (stdout) می‌نویسد. در صورت نوشتن در stdout، لطفاً آن را با گزینهٔ \-\-quiet ترکیب کنید تا از مخلوط شدن لاگ‌های خروجی pip با خروجی JSON جلوگیری شود. .sp (متغیر محیطی: \fBPIP_REPORT\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-group <[path:]group> نصب یک گروه وابستگی (dependency\-group) مشخص‌شده از یک فایل \(dqpyproject.toml\(dq. در صورت ارائهٔ مسیر، نام فایل حتماً باید \(dqpyproject.toml\(dq باشد. حالت پیش‌فرض استفاده از \(dqpyproject.toml\(dq در دایرکتوری جاری است. .sp (متغیر محیطی: \fBPIP_GROUP\fP) .UNINDENT .INDENT 0.0 .TP .B \-\-no\-clean عدم پاک‌سازی دایرکتوری‌های ساخت. .sp (متغیر محیطی: \fBPIP_NO_CLEAN\fP) .UNINDENT.SH "نویسندگان (AUTHORS)" توسعه‌دهندگان pip .SH "کپی‌رایت و تکثیر (COPYRIGHT)" توسعه‌دهندگان pip .\" End of generated man page.