未激活venv开发Django项目的后果及修复方法咨询

未激活venv时的实际状态 #

• 你的Python代码会使用系统全局Python环境（或终端默认的Python环境），而非你专门为项目创建的venv。
• 这段时间安装的所有第三方包（比如Django、各类工具库）都会被安装到全局环境的site-packages目录，和venv完全无关。
• 如果此时生成requirements.txt，文件里会包含全局环境的所有依赖，而非当前项目实际需要的子集。

可能出现的后果 #

• 项目失去移植性：把项目复制到新机器、或者重新创建venv时，会发现依赖缺失（因为依赖都在你的全局环境里），或者因依赖版本不匹配直接报错。
• 污染全局环境：大量项目依赖堆在全局，很容易和其他Python项目的依赖版本冲突，导致其他项目无法正常运行。
• 激活venv后项目跑不起来：venv里没有你之前安装的那些依赖，代码调用时会直接抛出ModuleNotFoundError。

修复步骤 #

1. 先激活你的venv
   • Windows：运行venv\Scripts\activate
   • macOS/Linux：运行source venv/bin/activate
2. 备份全局环境依赖（避免误删）
   在未激活venv的终端窗口里执行：pip freeze > global_requirements.txt，把全局的依赖列表存下来。
3. 给venv补装项目依赖
   激活venv后，先梳理项目代码用到的依赖（比如Django的具体版本、其他用到的库），然后用pip install逐一安装对应版本。如果之前生成过项目的requirements.txt，可以先尝试pip install -r requirements.txt，再根据运行时的报错补充缺失的依赖。
4. 清理全局环境（可选）
   如果你不想让全局环境留着多余的包，可以运行pip uninstall -r global_requirements.txt卸载之前误装的依赖，但要注意别删掉其他项目需要的包，最好先确认哪些是这个项目安装的。
5. 生成正确的项目依赖列表
   确认venv里的依赖齐全、项目能正常运行后，执行pip freeze > requirements.txt，这个文件就只包含当前项目需要的依赖了，后续移植或重建环境时直接用它就行。

内容的提问来源于stack exchange，提问作者user19712456