IDE无法识别已安装的decouple/unipath模块，Django项目依赖报错

核心问题 #

项目虚拟环境使用Python3.12，全局Python为3.7.9，版本差异导致依赖包安装路径不匹配，IDE调试器未关联正确虚拟环境，引发导入报错、安装失败等问题。

解决步骤 #

1. 激活项目虚拟环境 #

打开PowerShell，进入项目根目录，执行虚拟环境激活命令：

.\venv\Scripts\Activate.ps1

激活后命令行前缀会显示(venv)，确认当前使用虚拟环境的Python工具链。

2. 修复虚拟环境内的setuptools #

激活环境后，先升级setuptools确保安装环境正常：

python -m pip install --upgrade setuptools

3. 正确安装依赖包 #

注意：直接安装decouple会指向错误包，需安装python-decouple。在激活的虚拟环境中执行：

python -m pip install python-decouple unipath

4. 配置IDE关联虚拟环境 #

• 打开IDE的Python解释器设置，选择项目虚拟环境目录下的venv\Scripts\python.exe
• 重启IDE使配置生效

5. 验证修复效果 #

• 打开base.py检查导入语句是否仍报错
• 在激活的虚拟环境中运行项目：

python manage.py runserver

可选操作：统一Python版本 #

若不需要Python3.12，可删除现有虚拟环境，用全局3.7.9重建：

# 删除旧虚拟环境
Remove-Item -Recurse -Force venv
# 用Python3.7.9创建新环境
python3.7 -m venv venv

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