Python包管理工具pip用户指南

Python包管理工具pip用户指南

pip The Python package installer 项目地址: https://gitcode.com/gh_mirrors/pi/pip

什么是pip

pip是Python的包管理工具，用于安装和管理Python软件包。它是Python生态系统中最重要的工具之一，让开发者能够轻松地安装、升级和删除Python包。

pip的基本使用

运行pip命令

pip是一个命令行工具，安装后可以通过以下方式运行：

Unix/macOS系统：

python -m pip <pip参数>

Windows系统：

py -m pip <pip参数>

python -m pip表示使用指定的Python解释器执行pip，而Windows上的py -m pip会自动使用最新安装的Python解释器。

安装包

最常见的用法是从Python包索引安装包：

安装最新版本：

python -m pip install SomePackage

安装特定版本：

python -m pip install SomePackage==1.0.4

安装最低版本：

python -m pip install 'SomePackage>=1.0.4'

高级安装选项

使用网络代理

在企业环境中，可能需要通过网络代理连接：

1. 使用--proxy参数：

   python -m pip install --proxy http://user:pass@proxy.server:port SomePackage
   

2. 通过配置文件设置代理

3. 使用环境变量http_proxy、https_proxy和no_proxy

从wheel文件安装

Wheel是Python的二进制包格式，安装速度比源码安装快得多：

python -m pip install SomePackage-1.0-py2.py3-none-any.whl

如果需要安装wheel中的可选依赖项：

python -m pip install './somepackage-1.0-py2.py3-none-any.whl[my-extras]'

依赖管理

需求文件(requirements.txt)

需求文件是包含需要安装的包列表的文本文件：

python -m pip install -r requirements.txt

需求文件有4种常见用途：

1. 创建可重复的安装环境：

   python -m pip freeze > requirements.txt
   python -m pip install -r requirements.txt
   

2. 解决依赖冲突：明确指定依赖版本范围

3. 强制使用特定子依赖版本

4. 使用本地补丁版本：从版本控制系统安装修改后的依赖

约束文件(constraints.txt)

约束文件只控制安装的版本，不决定是否安装：

python -m pip install -c constraints.txt

与需求文件不同，约束文件中的包不会被自动安装，只有在其他依赖需要时才会安装。

依赖组(Dependency Groups)

依赖组是定义在pyproject.toml文件中的依赖集合：

[dependency-groups]
groupA = [
    "pkg1",
    "pkg2",
]

安装依赖组：

python -m pip install --group groupA

包管理操作

卸载包

python -m pip uninstall SomePackage

列出已安装的包

基本列表：

python -m pip list

列出过期的包：

python -m pip list --outdated

查看包详情：

python -m pip show SomePackage

搜索包

python -m pip search "查询词"

本地包管理

仅从本地安装

1. 先下载所有依赖：

   python -m pip download --destination-directory DIR -r requirements.txt
   

2. 然后从本地安装：

   python -m pip install --no-index --find-links=DIR -r requirements.txt
   

构建wheel文件

python -m pip install wheel
python -m pip wheel --wheel-dir=/local/wheels -r requirements.txt

命令行补全

pip支持多种shell的自动补全：

Bash：

python -m pip completion --bash >> ~/.profile

Zsh：

python -m pip completion --zsh >> ~/.zprofile

Fish：

python -m pip completion --fish > ~/.config/fish/completions/pip.fish

PowerShell：

python -m pip completion --powershell | Out-File -Encoding default -Append $PROFILE

总结

pip是Python开发者必不可少的工具，掌握其使用方法能极大提高开发效率。本文介绍了从基础安装到高级依赖管理的各种用法，包括需求文件、约束文件和依赖组等现代Python开发中常用的功能。合理使用这些功能可以帮助你创建更稳定、可重复的开发环境。

pip The Python package installer 项目地址: https://gitcode.com/gh_mirrors/pi/pip