Django虚拟环境移动后自动添加旧项目依赖问题求助

问题重现 #

• 在Mac的Dev目录创建虚拟环境：

  cd Dev
  python3 -m venv <venv名称>
  

• 激活虚拟环境后安装Django，执行pip list仅显示Django相关基础依赖：

  asgiref    3.5.2
  Django     4.0.6
  pip        22.0.4
  setuptools 58.1.0
  sqlparse   0.4.2
  

• 执行django-admin startproject <项目名称>创建项目，随后将venv文件夹移入项目主目录，再次运行pip list时，旧项目的所有依赖被加载进来。

原因分析 #

1. 虚拟环境未重新激活：移动venv后，终端仍在使用之前激活的环境（或全局环境），导致调用了外部pip
2. venv路径绑定问题：python3 -m venv创建的虚拟环境是路径依赖的，内部的bin/python、bin/pip等脚本硬编码了原始创建路径，移动后会指向错误的环境
3. Shell命令缓存干扰：Mac终端会缓存命令路径，移动venv后，shell仍调用旧路径下的pip

解决方案 #

步骤1：确认当前环境正确性 #

先检查当前使用的Python和pip是否属于移动后的venv：

# 查看Python路径，应指向项目目录下的venv/bin/python3
which python3
# 查看pip路径，应指向项目目录下的venv/bin/pip
which pip

步骤2：重新激活虚拟环境 #

进入项目主目录，重新激活venv：

cd <项目主目录>
source venv/bin/activate

激活后终端前缀会显示(venv)，此时再执行pip list验证。

步骤3：修复venv的路径绑定 #

如果重新激活后仍有问题，使用virtualenv修复路径（需先安装virtualenv）：

# 在激活的venv中安装virtualenv
pip install virtualenv
# 修复venv的路径依赖
virtualenv --relocatable venv

步骤4：避免全局命令干扰 #

激活venv后，优先使用python -m pip代替直接调用pip，确保调用的是当前venv内的pip：

python -m pip list

步骤5：重置Shell缓存 #

如果终端仍调用旧路径的命令，执行以下命令重置shell缓存：

hash -r

预防方案：直接在项目目录创建venv #

避免移动venv带来的路径问题，直接在项目目录内创建虚拟环境：

# 进入要创建项目的目录
cd <目标目录>
# 创建venv
python3 -m venv venv
# 激活
source venv/bin/activate
# 安装Django并创建项目（注意最后的".", 在当前目录生成项目结构）
pip install django
django-admin startproject <项目名称> .

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