在 Python 项目里，依赖包安装/升级看似简单，但最容易踩坑的其实是：装错环境、权限不足、内网无法访问、升级后不兼容。这篇文章用一个常见依赖 chinese_calendar 做例子，梳理一套稳定可复制的操作步骤。

---

1. 先搞清楚：你正在用哪个 Python / pip？

很多机器同时装了多个 Python（系统自带 + Anaconda + venv + Docker），最常见问题是：pip 装了，但运行的 python 不是同一个环境。

先执行：

which python
which pip
python -V
pip -V

• python -V 看解释器版本
• pip -V 会显示 pip 绑定的 Python 路径（关键！）

✅ 最推荐的习惯：永远用 python -m pip，避免装错环境：

python -m pip -V

---

2. 查看某个依赖是否已安装、当前版本是多少

pip show chinese_calendar

你会看到类似信息：

• Version：当前版本
• Location：安装路径（判断是不是装在你正在用的环境里）

---

3. 升级依赖到最新版本（推荐写法）

3.1 直接升级（最常用）

python -m pip install -U chinese_calendar

等价命令：

pip install -U chinese_calendar
pip install --upgrade chinese_calendar

为什么推荐 python -m pip？

• 能保证升级的包装到当前 python 对应的 site-packages 里，不容易装错。

---

4. 虚拟环境（venv / virtualenv）里的正确升级姿势

如果项目使用虚拟环境，务必先激活：

source venv/bin/activate

确认当前环境：

which python
python -V

升级依赖：

pip install -U chinese_calendar

---

5. Conda 环境里怎么升级？

如果你用 Anaconda/Miniconda：

conda activate your_env
python -m pip install -U chinese_calendar

说明：

• 很多第三方库conda 官方源没有或版本滞后，直接用 pip 更稳。

---

6. 查看 PyPI 上有哪些版本（可选）

如果你想确认“最新版本到底是什么”，可用：

pip index versions chinese_calendar

安装指定版本（生产建议固定版本）：

python -m pip install chinese_calendar==1.10.0

---

7. 常见坑与解决方案（运维/服务器环境高频）

7.1 权限不足（Permission denied）

常见于 Linux 全局 Python：

解决 1：仅为当前用户安装

python -m pip install -U chinese_calendar --user

解决 2：使用虚拟环境（推荐）

python -m venv venv
source venv/bin/activate
pip install -U chinese_calendar

---

7.2 内网环境无法访问 PyPI

可换国内镜像源（示例：清华镜像）：

python -m pip install -U chinese_calendar -i https://pypi.tuna.tsinghua.edu.cn/simple

如果你公司有私有源，优先用公司源地址。

---

7.3 pip 太旧导致无法安装/升级

python -m pip install --upgrade pip

---

8. 升级后如何验证？

8.1 命令行确认版本

pip show chinese_calendar

8.2 Python 代码确认（推荐）

import chinese_calendar
print(chinese_calendar.__version__)

---

9. 生产环境强烈建议：依赖版本要“可控”

开发机可以追最新，生产环境建议固定版本，避免“今天升级，明天服务挂了”。

9.1 导出依赖清单

pip freeze > requirements.txt

9.2 安装依赖清单

python -m pip install -r requirements.txt

9.3 固定某个包版本（示例）

在 requirements.txt 写：

chinese_calendar==1.10.0

---

10. 一套可复制的标准升级流程（推荐直接贴到项目文档）

# 1) 确认环境
which python
python -V

# 2) 查看当前版本
python -m pip show chinese_calendar

# 3) 升级到最新
python -m pip install -U chinese_calendar

# 4) 再次确认版本
python -m pip show chinese_calendar