Django项目依赖包导出与迁移：使用pip freeze和requirements.txt实现环境同步

脚本专家

在 Django 项目开发中，将开发环境的依赖包完整迁移到测试或生产环境是常见需求。本文详细介绍如何通过 pip freeze 命令导出依赖包列表，并利用 requirements.txt 在新环境中快速安装，同时说明 PyCharm 中的相关管理操作。

2. pip freeze > requirements.txt

复制代码

此命令会将当前 Python 环境中所有已安装的包及其版本号写入 requirements.txt 文件。典型输出如下：

Django==2.1.15
Pillow==7.1.2
PyMySQL==0.9.3
pytz==2019.3
uWSGI==2.0.18

文件内容为“包名==版本号”的集合。在新项目环境中安装这些依赖时，只需执行：

2. pip install -r requirements.txt

复制代码

这里的 -r 参数（--requirement）指示 pip 从指定文件读取依赖列表并依次安装。该参数可重复使用，支持从多个文件安装。

工作原理：pip freeze 的实质是扫描当前 Python 解释器（或虚拟环境）的 site-packages 目录，列出所有通过 pip 安装的包并记录精确版本。若当前环境未安装任何第三方包，导出的文件为空。因此，建议在项目初始化时即创建虚拟环境，并在安装所需包后执行导出。

在 PyCharm 中查看和管理依赖包：
进入菜单 PyCharm → Preferences → Project:[项目名] → Project Interpreter。右侧列表显示当前项目使用的所有已安装包。右上角的设置图标用于切换 Python 解释器（如从系统环境切换到虚拟环境）。左下角的“+”按钮可安装新包，安装后自动更新列表。

注意事项：
1. 导出前请确认当前环境与项目实际运行环境一致（使用虚拟环境可避免污染系统 Python）。
2. 若项目依赖 Git 仓库或本地路径的包，requirements.txt 可手动添加类似 -e git+https://... 的条目，但需谨慎处理。
3. 跨平台迁移时，注意部分包（如 uWSGI）在 Windows 下可能不可用，建议结合平台条件在 requirements.txt 中使用 Markers。

以上方法适用于 Django 及其他 Python 项目的环境同步场景，能有效保证开发、测试、生产环境依赖版本一致，减少因环境差异导致的部署问题。

热心网友1

感谢楼主的详细教程！pip freeze + requirements.txt 确实是 Python 项目环境迁移的标配，尤其配合虚拟环境使用能避免很多版本冲突的问题。 想请教一个问题：如果项目升级了某个依赖，但有的包依赖旧版本，比如 Django 从 2.2 升到 3.0 后 Pillow 可能需要同步更新，楼主一般是怎么处理这种依赖依赖冲突的？是手动调整 requirements.txt 里的版本号，还是用 pip-tools 这类工具自动解决？