【Python 基础】Python pip 使用指南（Windows 版）-CSDN博客

本博客处一处命令在 IDLE 使用（有声明）外，其余命令均在命令提示符，即 CMD 对话框内使用。
建议使用管理员权限运行 CMD 命令，以管理员权限打开 CMD 对话框方式：
1. 1）从【开始】菜单打开【运行】，或使用快捷键【Win+R】打开【运行】；2）在【运行】中输入"cmd"并使用快捷键【Ctrl+Shift+Enter】打开。
2. 1）打开任务管理器，使用快捷键【Ctrl+Shift+Esc】或在【运行】窗口中输入"taskmgr"或"taskmgr.exe"（旧版），"TM"（新版）；2）在【文件】菜单中选择【新建任务】或【运行新任务】（版本问题），输入"cmd"，并勾选【以管理员身份创建此任务】，然后点击【确定】。
3. 在【开始】菜单中输入"cmd"，右键【cmd.exe】程序，点击【以管理员身份运行】
检验当前打开的 CMD 对话框是否为管理员模式：
1. 输入命令"whoami"并回车，如果返回的是"Administrator"，则说明 CMD 对话框是以管理员身份运行的。
2. 输入命令"net session"，如果返回的是“访问被拒绝”，则说明 CMD 对话框不是以管理员身份运行的。
3. 没有解决权限问题请看第三大部分。
绝对路径与相对路径

绝对路径形式：

<盘符>:\<文件夹>\<文件夹>\...\<文件名>

例如：如果 CMD 对话框内路径如下：

C:\Users\Administrator>

而文件目录如下：

D:\Python\example.txt

则操作文件时需要使用文件的绝对路径（上述）。

而如果文件路径如下：

C:\Users\Administrator\Python\example.txt#--1
#or
C:\Users\Administrator\example.txt#--2

那么操作文件时只需用相对路径即可（也可以使用绝对路径），相对路径如下：

Python\example.txt#--1
#or
example.txt#--2

当然还可以更改 CMD 对话框中的路径，这里不在具体阐述（因为对于此篇博客没有太大必要）。

一、配置 pip

1、安装 pip

自动安装

在 Python 3.4 及以上版本，在安装 Python IDLE 时会自动安装。

Python 官网：Welcome to Python.org

IDLE 下载地址：Download Python | Python.org

手动安装

（1）事先检查

可以先检查一下是否安装了 pip：（在 CMD 对话框输入以下命名来检查）

pip --version

如果安装了会显示 pip 的版本信息，例如：

pip 25.0.1 from C:\Users\Administrator\AppData\Local\Programs\Python\Python38\lib\site-packages\pip (python 3.8)

没安装则会显示"python"不是内部或外部命令，也不是可运行的程序或批处理文件。

（2）安装 pip

如果没有安装，那可以使用以下命令来安装：（存在 pip 的安装程序 .whl 文件）

python -m ensurepip --default-pip

如果安装成功，则会在最后显示例如以下的提示信息：

Successfully installed pip-25.0.1

如果没有安装成功，可能是没有安装包，那就需要下载安装包。

（3）下载 pip 并安装

下载安装包，可以使用以下命令：（确保联网正常）

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

也可以通过浏览器直接访问 get-pip | pypa.io，并将下载内容保存为 get-pip.py 文件。

然后通过终端运行此程序，在 CMD 对话框中输入以下命令：

python get-pip.py

需要确保 CMD 对话框中的文件目录与此文件存放的文件目录相同。

（4）最后检查

最后同（1）一样检查 pip 是否安装成功。

2、卸载 pip

在 CMD 对话框中输入以下命令即可：

python -m pip uninstall pip

不询问卸载（上面卸载前会询问一次，增加以下参数后不再询问，其他模块卸载时相同）

python -m pip uninstall -y pip

3、配置环境变量

如果在安装 IDLE 是没有将 Python 添加到环境变量中或添加失败，那么就需要手动添加。

添加到环境变量（以 Windows 7 为例）：在【计算机】的【系统属性】中打开【更改设置】，点击【高级】，打开【环境变量】，在【系统变量】中找到并选中【Path】，点击【编辑】，在【变量值】最后增添上

C:\Users\<用户名>\AppData\Local\Programs\Python\Python<版本>\Scripts

例如：

C:\Users\Administrator\AppData\Local\Programs\Python\Python38\Scripts

（说明：在 Python 安装到的文件中找到并打开"Scripts"文件夹，获取其绝对路径），后依次点击【确定】，【确定】，【确定】。

Windows 10、11 及以上版本按同样的方式找到【环境变量】，在【编辑】时【新建】一个文件目录，再将上述的 Python 绝对路径复制上去保存即可。添加后保存时，有【应用】按钮的界面应先点击【应用】再点击【确定】。

4、查看 pip 信息

（1）查看 pip 版本信息

命令如下：

pip --version

（2）查看 pip 全部信息

命令如下：

pip show pip

5、设置镜像源

为了提高速度和稳定性，建议使用国内镜像源进行更新或安装。

设置全局 pip 镜像源

命令如下：

pip config set global.index-url [镜像源]

例如设置为清华大学镜像源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/

国内常用镜像源

（1）清华：https://pypi.tuna.tsinghua.edu.cn/simple/

（2）阿里云：http://mirrors.aliyun.com/pypi/simple/

（3）中国科技大学 https://pypi.mirrors.ustc.edu.cn/simple/

（4）华中理工大学：http://pypi.hustunique.com/

（5）山东理工大学：http://pypi.sdutlinux.org/

（6）豆瓣：http://pypi.douban.com/simple/

6、配置其他信息

找到文件夹（如果找不到，则在上级目录下创建一个同名文件夹及下述文件）：

C:\Users\<用户名>\AppData\Roaming\pip

例如

C:\Users\Administrator\AppData\Roaming\pip

打开 pip.ini 文件，里面包含信息如下：

[global]
timeout = 6000#下载超时时长
index-url = https://pypi.tuna.tsinghua.edu.cn/simple#下载的地址
trusted-host = pypi.tuna.tsinghua.edu.cn#受信任地址

可以根据个人需求更改里面的信息。

二、使用 pip

1、帮助信息

可以使用帮助信息来查看 pip 的使用语法。

帮助信息语法如下：

pip <command> -h

或着

pip <command> -help

例如查看 pip 的命令用法：

pip -h
#or
pip -help

再例如查看 pip install 的参数用法：

pip install -h
#or
pip install -help

2、安装库

1、基本语法

安装库的命令如下：

pip install [库名]

例如安装 pygame 库：

pip install pygame

如果安装成功则最后会显示：

Successfully installed [库名]-[版本]

例如：

Successfully installed pygame-2.6.1

2、安装指定版本

命令格式如下：

pip install [库名]==[版本]

例如安装版本为 5.3.1 的 lxml 模块：

pip install lxml==5.3.1

3、单次安装使用镜像源

单次安装使用镜像源命令如下：

pip install -i [镜像源] [库名]

或者

pip install [库名] -i [镜像源]

例如：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ wxPython
#or
pip install wxPython -i https://pypi.tuna.tsinghua.edu.cn/simple/
#of course
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ wxPython==4.2.2
#and
pip install wxPython==4.2.2 -i https://pypi.tuna.tsinghua.edu.cn/simple/
#are ok too.

4、批量安装库

（1）使用命令

pip install [库名1] [库名2] [库名3] [库名4] ...

或者

pip install [库名1]==[版本1] [库名2]==[版本2] [库名3]==[版本3] [库名4]==[版本4] ...

（2）使用文件

准备一个 txt 文本文件，添加要安装的库的信息，格式如下：

[库名1]
[库名2]
[库名3]
...

或者

[库名1]==[版本1]
[库名2]==[版本2]
[库名3]==[版本3]
...

例如：

openpyxl
PyAutoGUI
pillow
...
#or
openpyxl==3.1.5
PyAutoGUI==0.9.54
pillow==10.4.0
...

习惯性保存为文件 requirements.txt

再在 CMD 对话框中输入以下命令：

pip install -r <盘符>:\<文件夹>\...\requirements.txt

如果 CMD 对话框中的目录与文件目录一致，直接输入文件名即可，如下：

pip install -r requirements.txt

否则，需要输入文件的绝对路径，例如：

pip install -r D:\Python\requirements.txt

5、处理其他问题

（1）依赖冲突

禁用自动依赖解析：通过添加参数 --no-deps 来跳过依赖项的自动安装，从而避免潜在的冲突。

pip install [库名] --no-deps

手动指定版本号：针对特定依赖冲突，可以直接安装所需的具体版本。

pip install [库名]==[版本]

检查未满足的依赖关系：安装完成后，可使用 pip check 命令检测是否存在未满足的依赖条件。

pip check

（2）处理 SSL 证书问题

升级 pip 并强制忽略 SSL 错误：

python -m pip install --upgrade pip --trusted-host pypi.org --trusted-host files.pythonhosted.org

切换至国内镜像源：（这里展示的是单次安装使用镜像源，升级 pip，使用清华大学镜像源）

python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple

3、卸载库

1、基本语法

安装库的命令如下：

pip uninstall [库名]

例如：

pip uninstall selenium

卸载库的话就不需要指定版本和镜像源了，但如果指定版本不会报错，即使是个不存在的版本。

2、不询问卸载库

按照上述命令卸载库会询问一次，如下：

Proceed (Y/n)?

如果要取消询问只需增加一个参数，如下：

pip uninstall -y [库名]

例如：

pip uninstall -y Scrapy

3、批量卸载库

与批量安装库的准备相同（不需要有对应版本），只不过命令变成了如下：

pip uninstall -y -r <盘符>:\<文件夹>\...\requirements.txt

例如：

pip uninstall -y -r requirements.txt#目录需保存一致
#or
pip uninstall -y -r D:\Python\requirements.txt

4、升级库

1、查看需要升级的库

命令如下：

pip list -o

或者

pip list --outdated

2、升级库命令

命令格式如下：

pip install --upgrade [库名]

或者

pip install -U [库名]

例如：

pip install --upgrade PyQt5
#or
pip install -U PyQt5

3、升级 pip

命令如下：

pip install --upgrade pip
#or
pip install -U pip

或者

python -m pip install --upgrade pip

5、查看库

1、查看已安装的第三方模块

命令如下：

pip list

2、查看 Python 中的模块（标准模块和第三方模块）

在 IDLE 中输入以下命令：

help('modules')

3、查看模块的详细信息

命令格式如下：

pip show [库名]

例如：

pip show pywifi

如果想查看模块里有哪些文件，可以添加 -f 参数，如下：

pip show -f [库名]

例如：

pip show -f urllib3

4、将已安装的第三方库信息输出至文件

命令格式如下：

pip freeze > <路径>\<文件名>

路径必须存在，文件可以不存在。

如果路径不存在，会信息以下提示信息：

系统找不到指定的路径

如果文件存在，文件内原内容会被覆盖。

此命令同样需要注意绝对路径与相对路径的问题。

例如，如果 CMD 对话框内路径如下：

C:\Users\Administrator>

要输入到文件 packages.txt 中，路径为 D:\Python，则命令如下：

pip freeze > D:\Python\packages.txt

而如果使用了以下命令：

pip freeze > packages.txt

那么就需要去 C:\Users\Administrator 目录下找文件 packages.txt 了。

三、更多功能

1、安装预发布版

命令如下：

pip install --pre [库名]

例如：

pip install --pre twilio

2、安装本地包

命令如下：

pip install <路径>\<库名.tar.gz>

例如：

pip install D:\Python\pandas-2.3.1.tar.gz

同样需要注意路径（绝对路径与相对路径）问题。

3、清理缓存管理

清理缓存命令如下：

pip cache purge

4、权限与多用户问题

对于权限不够的情况，可以使用 --user 参数，这个参数的主要作用是将第三方库安装到当前用户的主目录下，而不是系统级的目录中。

这样就不需要管理员权限，普通用户就可以顺利地安装库了，安装到用户目录下的库，只对当前用户可见和可用，不会影响其他用户或系统的全局设置，这在多用户环境下非常实用。

参数命令格式如下：

pip install --user [库名]

例如：

pip install --user Flask

5、关键组件 setuptools 和 wheel

PyPI（PyPI 通过 pip 来安装和管理包）、setuptools 和 wheel 是 Python 包管理的关键组件，如果安装模块失败，可以尝试更新 setuptools 和 wheel 后再安装。

更新命令：

pip install --upgrade setuptools wheel
#or
pip install -U setuptools wheel

6、使用虚拟环境

创建虚拟环境，命令如下：

python -m venv myenv

激活环境，命令如下：

myenv\Scripts\activate

在虚拟环境中安装模块，命令如下：

pip install [库名]

例如：

pip install requests

7、管理模块的其他工具

工具	特点	适用场景
pip	官方标准、轻量级	基础包管理
conda	跨语言、管理环境	数据科学/跨平台
pipenv	依赖锁定+虚拟环境	应用开发
poetry	全生命周期管理	包开发与发布