Pipenv进入shell运行python报ModuleNotFoundError找不到django模块

按以下步骤操作时触发异常：

1. 执行pipenv install django安装Django依赖
2. 执行pipenv shell进入Pipenv虚拟环境
3. 执行django-admin startproject test .在当前目录创建测试项目
4. 执行python manage.py runserver尝试启动开发服务

执行后抛出报错：
ModuleNotFoundError: No module named 'django'
但改用pipenv run python manage.py runserver命令可以正常启动服务。
用户已经尝试过重装Pipenv、清除lock文件、删除.local目录下的虚拟环境，重新走完整流程后，在项目内的pipenv shell中运行python manage.py runserver仍然报相同错误，且此前进入pipenv shell后不需要加pipenv run前缀就可以直接执行相关命令。

这个问题本质是**pipenv shell没有正确把虚拟环境的Python解释器路径注入到当前Shell的PATH优先级最前面**，导致进入虚拟环境后调用的python还是系统全局的Python解释器，全局环境没装Django就会报模块找不到的错误。pipenv run是直接指定虚拟环境内的解释器执行命令，绕开了Shell激活的路径加载逻辑，所以可以正常运行。

常见触发场景：

• Shell配置文件（.bashrc/.zshrc/config.fish等）里硬编码了全局Python的PATH优先级，或者设置了python/python3的全局别名，覆盖了虚拟环境的路径配置
• 新版Pipenv和当前使用的终端（比如VSCode内置终端、部分第三方终端的Shell集成功能）存在兼容性问题，激活虚拟环境时VIRTUAL_ENV环境变量注入失败
• 系统里存在多个Python版本管理工具（比如pyenv、conda）的配置冲突，打乱了PATH加载顺序

按以下顺序排查修复即可：

• 先确认问题定位：进入pipenv shell后执行which python（macOS/Linux）或where python（Windows），如果输出路径和pipenv --venv返回的虚拟环境目录下的解释器路径不匹配，即可确认是路径加载失效问题。
• 排查Shell配置冲突：打开当前使用Shell对应的配置文件（bash对应~/.bashrc/~/.bash_profile，zsh对应~/.zshrc，fish对应~/.config/fish/config.fish），注释掉硬编码的全局Python路径配置、python/python3全局别名，以及会强制把全局路径放到PATH最前面的相关配置，保存后重启终端重试。
• 改用手动激活虚拟环境：跳过pipenv shell的自动激活逻辑，先执行pipenv --venv获取虚拟环境绝对路径，再手动执行对应激活脚本：
  • macOS/Linux：source 替换成你拿到的虚拟环境路径/bin/activate
  • Windows（命令提示符）：替换成你拿到的虚拟环境路径\Scripts\activate.bat
  • Windows（PowerShell）：替换成你拿到的虚拟环境路径\Scripts\Activate.ps1
    激活完成后再执行python manage.py runserver即可正常启动。
• 单会话快速修复：如果不想修改全局Shell配置，进入pipenv shell后直接执行alias python=$(pipenv --py)，将当前会话的python命令强制绑定到虚拟环境内的解释器，当前终端窗口内即可正常执行所有Python相关命令。
• 版本兼容修复：如果问题是在升级Pipenv之后出现，可降级到经过验证的稳定版本，执行pip install --user pipenv==2023.2.18完成安装后，删除旧虚拟环境重新走依赖安装流程即可。

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