pip 是 Python 的包管理器,没它装个库都得手动下载解压。这篇笔记记下我常用的操作和踩过的坑。
安装与验证
安装 Python 时务必勾选'Add Python to PATH',不然后面调用 pip 会提示找不到命令。装完打开终端,输入 python --version 和 pip --version,能看到版本号说明环境没问题。
基础命令
pip install 包名 # 安装最新版本
pip install 包名==版本号 # 安装指定版本
pip list # 列出已安装的包
pip show 包名 # 查看包详情
就这么几个,日常够用了。
虚拟环境
刚开始我总在全局环境直接 pip install,直到两个项目的依赖版本打架。后来学会了 python -m venv myenv。创建后激活:
- Windows:
myenv\Scripts\activate - macOS/Linux:
source myenv/bin/activate
激活后 pip install 的包全塞在这个小空间里,项目之间互不影响。习惯之后,每个项目单独建一个环境,目录里记得把 myenv 或 venv 加到 .gitignore。
依赖文件
团队协作或者把项目发给别人,都会用到 requirements.txt。生成它很简单:
pip freeze > requirements.txt
对方拿到后,一条命令还原环境:
pip install -r requirements.txt
这个文件就像项目的依赖说明,建议每个项目都加上。
常见报错与处理
- 网络慢或超时:换国内镜像源,例如清华源:
或者一劳永逸,写入 pip 配置文件。pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名 - 权限拒绝:提示 Permission denied,要么加上
--user装到用户目录,要么进虚拟环境操作。 - 版本冲突:先用
pip check看哪里冲突,再用pip install --upgrade 包名升级有问题的包。 - 包找不到:先确认包名拼写,或者直接上 pypi.org 搜索。别用
pip search,那个接口早就被禁了。
几个省事的操作
pip install -U 包名:安装或升级包。pip cache dir看缓存路径,pip cache purge清空缓存,释放磁盘。pip download 包名:先下载 whl 文件,再离线安装,适合无网环境。pip list --outdated:罗列当前可升级的包,方便批量更新。

