Python包管理工具pip完整安装教程

pip是Python官方的包管理工具，用于快速安装、卸载、更新Python第三方包，是Python开发的必备工具，Python 3.4及以上版本、Python 2.7.9及以上版本会默认自带pip，无需手动安装，仅需验证或配置即可；低版本则需手动安装，以下分全场景讲解安装、验证、配置及问题解决。

一、前置检查：查看Python安装与pip默认情况

1. 检查Python是否安装

打开电脑命令提示符（CMD，Windows） 或终端（Terminal，Mac/Linux），输入以下命令，能显示版本号即说明Python已安装：

bash

检查Python3（推荐）

python3 --version # Mac/Linux

python --version # Windows（多数情况Python3已映射为python）

检查Python2（不推荐，已停止维护）

python2 --version

2. 检查是否自带pip

在同一终端输入以下命令，显示pip版本号即说明已自带，可直接跳过安装步骤：

bash

对应Python3的pip（推荐）

pip3 --version # Mac/Linux

pip --version # Windows

对应Python2的pip

pip2 --version

若提示「不是内部或外部命令」，则说明未安装pip，需进行手动安装。

二、手动安装pip（适用于未自带pip的低版本Python）

方式1：通过官方脚本get-pip.py安装（跨平台通用，推荐）

这是最稳定的跨平台安装方式，兼容Windows、Mac、Linux，步骤如下：

1. 下载get-pip.py脚本

打开浏览器访问官方地址：https://bootstrap.pypa.io/get-pip.py，直接保存该文件（或通过终端命令下载，更高效）：

• Windows（CMD）：需先安装curl工具，或直接手动下载；

• Mac/Linux（终端）：

bash

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

2. 运行脚本安装pip

进入get-pip.py文件所在的目录（终端输入 cd 脚本保存路径 ），然后执行以下命令，自动安装适配当前Python的pip最新版本：

bash

对应Python3（推荐）

python3 get-pip.py # Mac/Linux

python get-pip.py # Windows

对应Python2

python2 get-pip.py

✅ 安装成功提示：终端会显示「Successfully installed pip-xxx wheel-xxx」（xxx为版本号）。

方式2：通过系统包管理器安装（仅Mac/Linux）

Mac（使用Homebrew，需先安装Homebrew）

bash

brew install python3 # 安装Python3的同时自动安装pip3

Linux（Ubuntu/Debian）

bash

sudo apt update

sudo apt install python3-pip # 安装Python3-pip

若为Python2

sudo apt install python2-pip

Linux（CentOS/RHEL）

bash

sudo yum install epel-release

sudo yum install python3-pip

三、配置环境变量（解决「pip不是内部或外部命令」）

若已安装pip但终端提示命令无效，核心原因是pip的安装路径未加入系统环境变量，需手动添加，步骤如下：

1. 找到pip的安装路径

pip的路径通常与Python的安装路径一致，在终端输入以下命令查找Python安装目录，pip一般在 Python目录/Scripts/ （Windows）或 Python目录/bin/ （Mac/Linux）下：

bash

Windows查找Python路径

where python

Mac/Linux查找Python路径

which python3

2. Windows添加环境变量

3. 复制找到的 Scripts 文件夹路径（如 C:\Python311\Scripts ）；

4. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；

5. 在「用户变量」或「系统变量」中找到「Path」，点击「编辑」→「新建」，粘贴复制的路径；

6. 点击「确定」保存，关闭原有终端，重新打开即可生效。

7. Mac/Linux添加环境变量（临时/永久）

临时生效（仅当前终端）

直接在终端输入，将pip路径添加到临时环境变量：

bash

export PATH=$PATH:/usr/local/python3/bin # 替换为实际的pip所在bin目录

永久生效（所有终端）

1. 编辑bash配置文件（若为zsh终端，编辑~/.zshrc）：

bash

vi ~/.bash_profile

2. 在文件末尾添加以下内容，保存并退出（vi编辑器按 i 编辑， esc + :wq 保存）：

bash

export PATH=$PATH:/usr/local/python3/bin # 替换为实际pip路径

3. 使配置生效：

bash

source ~/.bash_profile

zsh终端执行

source ~/.zshrc

四、pip升级：更新到最新版本

刚安装的pip可能不是最新版本，建议升级到最新版，避免后续安装包时出现兼容问题，终端输入以下命令：

bash

对应Python3（推荐）

pip3 install --upgrade pip # Mac/Linux

pip install --upgrade pip # Windows

若升级后提示命令无效，用python -m方式升级（万能方法）

python3 -m pip install --upgrade pip # Mac/Linux

python -m pip install --upgrade pip # Windows

五、验证pip安装成功

重新打开终端，输入以下命令，能显示pip版本号和对应Python路径，即说明安装+配置全部成功：

bash

推荐（Python3）

pip3 --version # Mac/Linux

pip --version # Windows

示例成功输出： pip 24.0 from c:\python311\lib\site-packages\pip (python 3.11)

六、pip换源：解决安装包速度慢的问题（必做优化）

默认情况下，pip从国外PyPI官网下载包，速度较慢，国内用户建议切换为国内镜像源（如清华、阿里、豆瓣），分为「临时换源」和「永久换源」，推荐永久换源，一劳永逸。

1. 临时换源（仅当前安装命令生效）

安装包时，通过 -i 参数指定镜像源，示例：

bash

用清华源安装numpy包

pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple

2. 永久换源（所有pip命令默认使用国内源）

Windows系统

1. 在电脑中打开路径： C:\Users\你的用户名\AppData\Roaming （若找不到AppData，开启「隐藏项目」）；

2. 在该路径下新建文件夹，命名为 pip ；

3. 在 pip 文件夹中新建文本文档，重命名为 pip.ini （注意后缀从 .txt 改为 .ini ，需关闭「隐藏已知文件类型的扩展名」）；

4. 打开 pip.ini ，粘贴以下内容（以清华源为例，可替换为其他源），保存关闭：

ini

global

index-url = https://pypi.tuna.tsinghua.edu.cn/simple

install

trusted-host = pypi.tuna.tsinghua.edu.cn

Mac/Linux系统

1. 打开终端，输入以下命令创建pip配置文件：

bash

mkdir -p ~/.config/pip && vi ~/.config/pip/pip.conf

2. 在编辑器中粘贴以下内容（清华源），按 i 编辑， esc + :wq 保存：

conf

global

index-url = https://pypi.tuna.tsinghua.edu.cn/simple

install

trusted-host = pypi.tuna.tsinghua.edu.cn

国内常用镜像源（替换上述index-url即可）

plaintext

清华源（推荐，速度快）

https://pypi.tuna.tsinghua.edu.cn/simple

阿里源

https://mirrors.aliyun.com/pypi/simple/

豆瓣源

https://pypi.doubanio.com/simple/

中科大源

https://pypi.mirrors.ustc.edu.cn/simple/

七、常见问题与解决方法

1. 安装/升级pip时提示「权限不足」

• Windows：以管理员身份打开CMD，再执行命令；

• Mac/Linux：在命令前加 sudo ，输入系统密码即可，示例：

bash

sudo pip3 install --upgrade pip

2. 多Python版本共存，pip指向错误

问题：电脑同时装了Python2和Python3，pip默认指向Python2，导致安装的包无法在Python3中使用。

解决：始终用 python -m pip 方式执行命令，强制绑定当前Python版本，万能用法：

bash

Python3执行pip

python3 -m pip install 包名 # Mac/Linux

python -m pip install 包名 # Windows

Python2执行pip

python2 -m pip install 包名

3. 安装包时提示「SSL证书验证失败」

解决：在pip命令后添加 --trusted-host 镜像源域名 ，或在配置文件中添加 trusted-host （已在永久换源中配置，可避免该问题）。

4. Mac/Linux升级pip后提示「pip: command not found」

解决：用python -m方式重新升级，或创建软链接（以Python3.11为例）：

bash

sudo ln -s /usr/local/python3.11/bin/pip3 /usr/local/bin/pip

八、pip基础使用（安装成功后快速上手）

验证pip成功后，可通过以下基础命令管理包，快速上手：

bash

安装包（指定版本，不指定则装最新版）

pip install 包名==版本号 # 示例：pip install pandas==2.1.0

卸载包

pip uninstall 包名

查看已安装