pip install 常用命令大全

最新推荐文章于 2025-07-11 17:36:35 发布

原创最新推荐文章于 2025-07-11 17:36:35 发布 · 836 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#pip #编辑器 #pycharm #python #scipy #pandas #numpy

“pip install 常用命令大全”

前言

在 Python 生态中，pip 是最常用的包管理工具。它可以帮助我们轻松地安装、升级、卸载第三方库，也支持从本地目录、Git 仓库等多种来源获取包。本文将系统梳理 pip install 的各类常用命令及最佳实践，助你在日常开发、部署和运维中游刃有余。

一、pip 简介

pip：Python 包安装工具（Package Installer for Python）。
版本要求：自 Python 2.7.9+、3.4+ 起，官方默认捆绑 pip；也可单独通过 get-pip.py 安装。
主要功能：安装（install）、卸载（uninstall）、查询（show、list）、配置（config）等。

二、安装与升级 pip

1. 安装 pip

# 推荐方式：使用官方脚本
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

2. 升级 pip

# 全局环境
pip install --upgrade pip
# 指定 Python 3
python3 -m pip install --upgrade pip

三、基本安装命令

1. 单个包安装

pip install requests

2. 安装特定版本

pip install Django==3.2.10

3. 安装版本范围

# 大于等于1.0，小于2.0
pip install "flask>=1.0,<2.0"

4. 安装最新版本

pip install --upgrade numpy

四、Requirements 文件

1. 导出依赖

pip freeze > requirements.txt

2. 一键安装

pip install -r requirements.txt

Tip：可使用 --no-cache-dir 强制不使用缓存，确保获取最新包。

五、本地与编辑模式安装

1. 本地目录

pip install ./my_package/

2. 从压缩包或 wheel

pip install dist/my_package-0.1.0-py3-none-any.whl
pip install my_package-0.1.0.tar.gz

3. 编辑模式（开发中常用）

pip install -e ./my_package/

安装后，修改源码即时生效，适合持续开发调试。

六、从源码仓库安装

# GitHub
pip install git+https://github.com/psf/requests.git@master
# 指定子目录
pip install git+https://github.com/user/repo.git@v1.0#egg=repo&subdirectory=src

七、代理、超时与信任

代理：

pip install --proxy=http://user:pass@proxy.server:8080 package_name

超时（默认 15 秒）：
```
pip install --timeout=60 package_name
```

信任源（自签名或企业内网源）：

pip install --trusted-host pypi.internal.local -i http://pypi.internal.local/simple package_name

八、性能优化与缓存

并行下载（pip 21.3+）：

pip install -v --use-feature=fast-deps -r requirements.txt

缓存目录：

# 查看缓存位置
pip cache dir
# 清理缓存
pip cache purge

九、配置文件

在 ~/.pip/pip.conf（Linux/macOS）或 %APPDATA%\pip\pip.ini（Windows）中可统一配置：

[global]
timeout = 30
trusted-host = pypi.tuna.tsinghua.edu.cn
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

十、常见问题与排查

SSL 证书错误
添加 --trusted-host 或安装系统根证书。

速度慢
使用国内镜像（清华、阿里云等）：

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

权限不足（Permission denied）
- 使用虚拟环境（推荐）
- 或者：pip install --user package_name
包冲突
结合 pipdeptree、pip check 排查依赖冲突：
```
pip install pipdeptree
pipdeptree
pip check
```

十一、与虚拟环境配合

venv（Python 自带）：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

virtualenv / pipenv / poetry：各有特点，均可隔离依赖。

十二、总结

本文从基础安装、版本管理、依赖导入、编辑模式、本地与远程源码安装，到代理配置、缓存优化、常见排查，全面覆盖了 pip install 的常用命令与高级用法。熟练掌握这些技巧，能让你的 Python 项目依赖管理更稳健、高效。欢迎收藏、分享和在评论区补充你的常用秘笈！