Python pip 命令详解
pip 是 Python 的包管理工具,用于安装和管理 Python 包。以下是 pip 的主要命令及其作用:
1. 基础包管理命令
安装包
pip install package_name
-
安装指定的 Python 包
-
示例:
pip install requests
pip install package_name==1.0.4
-
安装指定版本的包
pip install 'package_name>=1.0.4'
-
安装不低于指定版本的包
升级包
pip install --upgrade package_name
-
升级指定的包到最新版本
-
简写:
pip install -U package_name
卸载包
pip uninstall package_name
-
卸载指定的 Python 包
查看已安装包
pip list
-
列出所有已安装的包及其版本
pip list --outdated
-
列出所有可升级的包
2. 包信息查询
查看包详情
pip show package_name
-
显示包的详细信息,包括版本、依赖、安装位置等
搜索包
pip search "query"
-
从 PyPI 搜索包(注意:PyPI 已禁用搜索功能,建议直接访问 pypi.org 搜索)
3. 依赖管理
生成依赖文件
pip freeze > requirements.txt
-
将当前环境的所有包及其版本导出到 requirements.txt 文件
从依赖文件安装
pip install -r requirements.txt
-
根据 requirements.txt 文件安装所有依赖包
4. 环境管理
检查 pip 版本
pip --version
-
显示当前 pip 版本
升级 pip 自身
pip install --upgrade pip
-
将 pip 升级到最新版本
5. 高级用法
从特定源安装
pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple
-
从指定的镜像源安装包(示例使用清华源)
安装开发模式
pip install -e .
-
以可编辑模式安装当前目录的包(通常在开发包时使用)
安装预发布版本
pip install --pre package_name
-
安装包的预发布版本(alpha/beta/rc版本)
安装指定平台包
pip install package_name --platform manylinux1_x86_64 --only-binary=:all:
-
安装特定平台的二进制包
6. 缓存管理
清理缓存
pip cache purge
-
清除 pip 的下载缓存
查看缓存信息
pip cache info
-
显示缓存统计信息
7. 配置相关
显示配置
pip config list
-
列出当前的 pip 配置
设置全局镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
-
设置全局 pip 镜像源(示例为清华源)
8. 虚拟环境相关
在虚拟环境中使用
python -m venv myenv # 创建虚拟环境
source myenv/bin/activate # 激活虚拟环境 (Linux/Mac)
myenv\Scripts\activate # 激活虚拟环境 (Windows)
pip install package_name # 在虚拟环境中安装包
9. 疑难解答
检查依赖冲突
pip check
-
检查已安装包是否有依赖冲突
显示安装日志
pip install package_name --verbose
-
显示详细的安装过程信息
10. 其他有用命令
下载包但不安装
pip download package_name
-
下载包及其依赖到当前目录
安装本地包文件
pip install /path/to/package.whl
-
从本地 .whl 文件安装包
哈希校验模式
pip install package_name --require-hashes -r requirements.txt
-
启用哈希校验模式,增强安全性
最佳实践提示
-
总是使用虚拟环境:避免污染系统Python环境
-
使用 requirements.txt:记录项目依赖
-
指定版本范围:如
package_name>=1.0,<2.0
-
定期更新:定期运行
pip list --outdated
检查更新 -
使用可信源:只从官方PyPI或可信镜像源安装包
以上命令适用于大多数现代 pip 版本 (pip 20.0+)。如需特定版本的帮助,可以使用 pip help <command>
查看详细文档。