经纬日记

pip 基础命令:写 Python 离不开,但很多人其实没用明白

刚开始写 Python 的时候,我对 pip 的理解只有一句话:
“装库用的。”

后来项目多了、环境乱了,才发现 pip 用不好,真的会把人折腾到怀疑人生。

这篇文章不讲原理,也不讲虚拟环境那一套,只整理我平时最常用、最容易踩坑的 pip 基础命令


一、先确认:你用的是哪个 pip?

这是我新环境里第一个会敲的命令

pip --version

你会看到类似这样的输出:

pip 23.3.1 from ... (python 3.10)

重点看两点:

  • pip 版本
  • 关联的是哪个 Python

如果你电脑里装了多个 Python,强烈建议用这种方式

python -m pip --version

这样可以避免 pip 和 python 对不上号的问题。


二、安装库:最基础,但坑也最多

1️⃣ 安装一个库

pip install requests

指定版本:

pip install requests==2.31.0

安装一个大概范围的版本:

pip install "requests>=2.30,<3.0"

2️⃣ 升级库

pip install -U requests

很多“莫名其妙的 bug”,升级一下就没了。


3️⃣ 从 requirements.txt 安装

pip install -r requirements.txt

这是团队协作和部署时的标配操作。


三、查看当前环境里装了什么

查看已安装库列表

pip list

只看某个库:

pip show requests

会看到版本、安装路径、依赖关系等信息,排查问题很有用。


导出依赖列表

pip freeze > requirements.txt

这个命令我用得非常多:

  • 项目交付
  • 部署服务器
  • 本地环境备份

四、卸载库(有时候比安装更重要)

pip uninstall requests

如果你发现:

  • 包版本乱
  • 依赖冲突
  • 环境已经“脏”了

那就果断卸载重装,比硬扛靠谱


五、常见但容易被忽略的实用命令

1️⃣ 查看可升级的库

pip list --outdated

这个命令很适合定期跑一遍,看看哪些库落后太多。


2️⃣ 不走缓存安装(解决玄学问题)

pip install --no-cache-dir numpy

当你遇到安装异常、下载奇怪文件时,很有用。


3️⃣ 指定国内镜像(速度差距很明显)

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

我一般会直接写进配置文件,省得每次敲。


六、pip 和虚拟环境的一点建议

如果你现在还没用虚拟环境,至少记住这句话:

不要在系统 Python 里随便 pip install

最简单的用法:

python -m venv venv
source venv/bin/activate  # Mac / Linux
venv\Scripts\activate     # Windows

激活后再用 pip,基本能避开 80% 的环境问题。


七、我自己总结的 pip 使用习惯

  • 永远用 python -m pip
  • 新项目第一步:建虚拟环境
  • requirements.txt 一定要有
  • 出问题时,先 pip list,再怀疑人生

写在最后

pip 看起来只是个装包工具,但它其实决定了你 Python 环境的稳定程度

很多“Python 怎么这么难用”的抱怨,最后发现根源都在 pip 和环境管理上。

把这些基础命令用顺了,写代码真的会轻松很多。


0 浏览