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
  • 启用哈希校验模式,增强安全性

最佳实践提示

  1. 总是使用虚拟环境:避免污染系统Python环境

  2. 使用 requirements.txt:记录项目依赖

  3. 指定版本范围:如 package_name>=1.0,<2.0

  4. 定期更新:定期运行 pip list --outdated 检查更新

  5. 使用可信源:只从官方PyPI或可信镜像源安装包

以上命令适用于大多数现代 pip 版本 (pip 20.0+)。如需特定版本的帮助,可以使用 pip help <command> 查看详细文档。

posted @ 2025-07-01 13:47  郭慕荣  阅读(228)  评论(0)    收藏  举报