Python包管理工具pip完全指南

目录

一、简介

二、安装和配置pip

Ubuntu系统安装pip

CentOS系统安装pip

macOS系统(确保已经安装了Homebrew）安装pip

通过源码安装pip

三、基本命令和用法

3.1、安装和卸载包

（1）pip安装包的命令：

（2）pip卸载已安装的包的命令：

3.2、包管理

（1）要查看已安装的包，可以使用以下命令：

（2）要更新已安装的包，可以使用以下命令：

（3）要查找特定包及其版本，可以使用以下命令：

3.3、包依赖管理

（1）要安装指定版本的包，可以使用以下命令：

（2）要解决包依赖冲突，可以尝试以下方法：

3.4、虚拟环境管理

3.4.1 python3 venv 命令

3.4.2 使用 virtualenv

四、高级用法

4.1、自定义pip的配置

4.2、使用requirements.txt文件管理项目依赖

4.3、创建和发布自己的Python包

4.4、使用pip下载非Python包资源

一、简介

pip是Python的包管理工具，用于安装、升级和卸载Python包。它是Python Package Index（PyPI）的默认包管理工具，PyPI是一个存储了大量Python包的仓库。pip的作用是简化Python包的安装和管理过程，使开发者能够更方便地获取和使用第三方库。它不仅提供了基本的安装和卸载功能，还支持包的版本管理、依赖解决、虚拟环境创建等高级功能，使得Python开发变得更加高效和灵活。

掌握pip对Python开发至关重要的原因有几点：

1. pip提供了简单易用的命令行界面，使得安装、升级和卸载Python包变得非常方便。可以通过一行命令完成包的安装，无需手动下载和配置。

2. PyPI作为一个庞大的Python包仓库，拥有海量的第三方库可供选择。通过pip可以轻松地获取和使用这些库，提高开发效率，避免重复造轮子。

3. pip支持对包的不同版本进行管理，可以方便地切换和管理不同版本的依赖。这对于项目的维护和升级非常重要，能够更好地控制包的兼容性和稳定性。

4. pip能够自动解决包之间的依赖关系，避免了手动处理包依赖的繁琐工作。只需指定依赖关系，pip会自动安装和管理所需的依赖包，简化了项目的配置和部署过程。

5. pip支持创建和管理虚拟环境，使得不同项目之间的依赖隔离和管理变得更加容易。可以为每个项目创建独立的虚拟环境，并在其中安装所需的包，避免了不同项目之间的冲突。

二、安装和配置pip

安装pip有多种方法，可以通过包管理器、源码安装等方式进行安装。

1. 使用包管理器：对于不同的操作系统，可以使用相应的包管理器进行pip的安装。例如，在Ubuntu上可以使用apt-get命令进行安装，在CentOS上可以使用yum命令进行安装，在macOS上可以使用Homebrew进行安装。

2. 源码安装：可以从官方网站

Ubuntu系统安装pip

1. 打开终端，输入以下命令以更新软件包列表：

2. 安装pip包：

3. 安装完成后，可以通过以下命令来验证pip是否成功安装：

CentOS系统安装pip

1. 打开终端，输入以下命令以更新软件包列表：

2. 安装pip包：

3. 安装完成后，可以通过以下命令来验证pip是否成功安装：

macOS系统(确保已经安装了Homebrew）安装pip

1. 打开终端，输入以下命令以更新Homebrew：

2. 安装pip包：

3. 安装完成后，可以通过以下命令来验证pip是否成功安装：

通过源码安装pip

1. 访问pip的官方网站

2. 解压下载的源码包。

3. 打开终端，进入解压后的目录。

4. 执行python setup.py install命令进行安装。

5. 安装完成后，可以通过pip --version命令来验证pip是否成功安装。

pip的常见选项和设置可以通过pip的配置文件进行修改。pip的配置文件位于用户主目录下的.pip目录中（例如Linux系统下的~/.pip/pip.conf）。

在配置文件中，可以设置以下常见选项：

1. index-url：指定pip使用的包索引地址。可以使用国内的镜像源来加快包的下载速度，例如使用阿里云的镜像源可以设置为

​ index-url = https://mirrors.aliyun.com/pypi/simple/ ​

1. trusted-host：指定pip信任的主机名。在使用自定义的镜像源时，可能会遇到SSL证书验证失败的问题，可以通过设置trusted-host来解决。例如：trusted-host = mirrors.aliyun.com

2. timeout：设置pip请求的超时时间。可以根据网络状况设置适当的超时时间，单位为秒。例如：timeout = 10

3. proxy：设置pip使用的代理服务器。如果需要通过代理服务器访问包索引或下载包文件，可以在此处指定代理服务器的地址和端口。例如：

​ proxy = http://proxy.example.com:8080 ​

1. no-cache-dir：禁用pip缓存下载的包文件。可以通过设置no-cache-dir = true来禁用缓存，每次都重新下载包文件。

如果使用pip的命令行选项指定了某个选项的值，将会覆盖配置文件中的设置。例如，如果在命令行中使用了--index-url选项指定了包索引地址，将会覆盖配置文件中的index-url设置。

三、基本命令和用法

3.1、安装和卸载包

（1）pip安装包的命令：

pip install [包名] # 例如，如果想要安装numpy包，可以使用以下命令： pip install numpy

（2）pip卸载已安装的包的命令：

pip uninstall [包名] # 例如，如果想要卸载numpy包，可以使用以下命令： pip uninstall numpy

3.2、包管理

（1）要查看已安装的包，可以使用以下命令：

pip list

（2）要更新已安装的包，可以使用以下命令：

pip install --upgrade [包名] #例如，如果想要更新numpy包，可以使用以下命令： pip install --upgrade numpy

（3）要查找特定包及其版本，可以使用以下命令：

pip search [包名] #例如，如果想要查找numpy包及其版本，可以使用以下命令： pip search numpy

3.3、包依赖管理

（1）要安装指定版本的包，可以使用以下命令：

pip install [包名]==[版本号] #例如，如果想要安装numpy的1.18.1版本，可以使用以下命令： pip install numpy==1.18.1

（2）要解决包依赖冲突，可以尝试以下方法：

• 更新pip版本：pip install --upgrade pip

• 使用虚拟环境：创建一个独立的Python虚拟环境，并在该环境中安装和管理您的包，以避免依赖冲突。

• 手动解决依赖：根据报错信息，逐个尝试安装特定版本的包来解决依赖冲突。

3.4、虚拟环境管理

3.4.1 python3 venv 命令

1. 创建虚拟环境： 其中myenv是您的虚拟环境名称。

python -m venv myenv

1. 激活虚拟环境：

# Windows: myenv\Scripts\activate # Macos/Linux: source myenv/bin/activate # 退出虚拟环境 deactivate # 删除 venv rm -r myenv # Linux/Mac # 或者 rmdir /s /q myenv # Windows # 删除 virtualenv rm -r myenv # Linux/Mac # 或者 rmdir /s /q myenv # Windows # 删除 conda conda env remove --name myenv # 删除 pipenv pipenv --rm

1. 一旦虚拟环境激活，使用pip安装包：

pip install package_name # or pip install -r requirements.txt

3.4.2 使用 virtualenv

1. 要创建虚拟环境，可以使用以下命令：

pip install virtualenv virtualenv [虚拟环境名称] 例如，如果想要创建一个名为myenv的虚拟环境，可以使用以下命令： pip install virtualenv virtualenv myenv

1. 要激活虚拟环境，可以使用以下命令：

source [虚拟环境名称]/bin/activate ## 例如，如果想要激活名为myenv的虚拟环境，可以使用以下命令： source myenv/bin/activate ## 要退出虚拟环境，可以使用以下命令： deactivate ## 这将返回到系统默认的Python环境。

四、高级用法

4.1、自定义pip的配置

1. 找到pip的配置文件：可以在终端中运行以下命令来找到pip的配置文件位置：

pip config -v list # 会看到pip的配置文件路径，类似于： Configuration files (ordered): '/home/fly/python/pip.conf'

1. 创建或编辑pip的配置文件：使用文本编辑器打开该路径下的pip.conf文件，如果文件不存在，则创建一个新的文件。

2. 在pip.conf文件中，可以使用以下配置选项来自定义pip的配置：

• index-url：指定默认的软件源URL，用于安装包。例如：index-url = https://pypi.org/simple

• trusted-host：指定信任的主机名，用于与软件源建立连接。例如：trusted-host = pypi.python.org

• timeout：指定连接超时时间，以秒为单位。例如：timeout = 60

确保每个配置选项都在单独的一行上，并使用等号（=）分隔键和值。

1. 保存并关闭pip.conf文件。

这样就已经成功自定义了pip的配置。在使用pip时，它将使用在pip.conf文件中设置的配置选项。

4.2、使用requirements.txt文件管理项目依赖

使用requirements.txt文件是一种常见的管理项目依赖的方法。该文件通常位于项目根目录下，其中列出了项目所需的所有依赖包及其版本号。通过运行命令pip install -r requirements.txt，可以自动安装所有依赖包，确保项目在不同环境中的一致性。

当使用requirements.txt文件管理项目依赖时，可以按照以下示例格式编写该文件：

package1==1.0.0 package2>=2.1.0,<3.0.0 package3

其中，每一行表示一个依赖包及其版本号。例如，第一行表示需要安装package1的版本1.0.0，第二行表示需要安装package2的版本大于等于2.1.0且小于3.0.0，第三行表示需要安装最新版本的package3。

在使用requirements.txt文件安装项目依赖时，只需要运行以下命令：

pip install -r requirements.txt

这将自动安装requirements.txt文件中列出的所有依赖包及其对应的版本。这样可以确保项目在不同环境中的依赖一致性，并且方便其他开发者在新环境中部署项目。

使用 pip freeze 命令输出依赖及其版本信息，并重定向到 requirements.txt 文件。在命令行中执行以下命令

pip freeze > requirements.txt

4.3、创建和发布自己的Python包

创建和发布自己的Python包是一种将自己的代码封装成可重用的模块的方法。

1. 创建一个新的目录，用于存放包的代码。

2. 在包目录中编写代码，包括需要提供给其他开发者使用的函数、类等。

3. 创建setup.py文件：在包目录中创建一个名为setup.py的文件，该文件包含了用于打包和安装包的元数据和配置信息。其中包括包的名称、版本号、作者、描述等。

4. 运行命令python setup.py sdist，将代码打包成一个源代码分发包。

5. 可以选择将打包好的包上传到Python包索引(PyPI)上，以便其他开发者可以使用pip安装你的包。可以使用命令twine upload dist/*将包上传到PyPI。

6. 其他开发者可以使用命令pip install your-package-name来安装你的包。

在发布之前，建议先阅读官方文档。

4.4、使用pip下载非Python包资源

当使用pip下载非Python包资源（例如数据集、模型等）时，可以使用pip的扩展工具pip-download。pip-download可以帮助下载非Python包资源，并将其保存到本地目录中。

使用pip-download下载非Python包资源：

1. 运行命令pip install pip-download来安装pip-download工具。

2. 在项目目录中创建一个名为requirements.txt的文件，该文件列出了要下载的非Python包资源的名称和版本号。

3. 运行命令pip download -r requirements.txt --dest=/path/to/save，其中/path/to/save是要保存资源的本地目录路径。这将根据requirements.txt文件中列出的资源，下载并保存到指定的目录中。

这样就可以使用pip-download下载非Python包资源，并将其保存到本地目录中。