Mac系统Django执行migrate报错No module named 'psycopg2'如何解决
2026-9-27
报错信息：django.core.exceptions.ImproperlyConfigured: Error loading psycopg2 module: No module named 'psycopg2'
修复步骤
1. 确认虚拟环境激活状态
- 终端激活虚拟环境后，前缀会显示
(你的虚拟环境名称)标识，若没有标识说明未成功激活 - 进入虚拟环境根目录后执行对应激活命令：
- Linux/macOS：
source bin/activate - Windows cmd：
.\Scripts\activate.bat - Windows PowerShell：
.\Scripts\Activate.ps1
- Linux/macOS：
2. 校验pip和Python的对应关系
- 执行
pip -V查看pip绑定的Python路径，确认路径中包含你正在使用的虚拟环境目录 - 执行
python -V确认当前Python版本，和pip绑定的Python版本保持一致，避免出现跨环境调用的问题
3. 重新安装psycopg2依赖
- 先卸载已安装的冲突包：
pip uninstall -y psycopg2 psycopg2-binary - 重新安装对应版本的包：
pip install psycopg2-binary==2.9.1 - 安装完成后先验证导入：执行
python进入交互终端，输入import psycopg2，无报错即为安装正常
4. 特殊场景兼容修复
如果上述步骤执行后仍然报错，检查以下配置：
- Django项目
settings.py中数据库ENGINE配置需为'ENGINE': 'django.db.backends.postgresql_psycopg2' - 若使用Python 3.10及以上版本，psycopg2-binary 2.9.1存在兼容性问题，可升级到更高兼容版本：
pip install psycopg2-binary>=2.9.3 - Windows环境需先安装对应版本的Visual C++运行库，再重新安装依赖包
内容的提问来源于stack exchange，提问作者Lonely wolf
相关产品推荐
相关产品推荐
