使用venv虚拟环境时pip安装依赖失败及导入问题求助

为啥pip install -r requirements.txt会安装失败？ #

其实就是psycopg2缺少编译依赖导致的。psycopg2是Python连接PostgreSQL的驱动，它底层依赖PostgreSQL的客户端开发库，你的系统里没装这个库，所以编译psycopg2源码的时候直接报错了。

看报错信息里已经说得很明确了：

Error: b'You need to install postgresql-server-dev-X.Y for building a server-side extension or libpq-dev for building a client-side application.\n'

你要装的是客户端应用（用Python连PostgreSQL），所以只需要装libpq-dev这个包就行。

为啥装了python-psycopg2后，./manage.py db upgrade会找不到Flask？ #

你用apt-get装的python-psycopg2是给系统全局Python用的，而你用的是venv虚拟环境——这俩环境是完全隔离的，虚拟环境里根本没装Flask、Flask-SQLAlchemy这些包，当然会报ModuleNotFoundError。

而且就算你装了系统版的psycopg2，虚拟环境里还是没有这个包，因为默认情况下虚拟环境不会继承系统的Python包（除非你创建环境时加了--system-site-packages，但这通常不推荐）。

正确的解决步骤 #

1. 先装系统层面的依赖，搞定psycopg2的编译问题：

   sudo apt-get update
   sudo apt-get install libpq-dev python3-dev
   

   要是你的系统用的是Python2，把python3-dev换成python-dev就行。

2. 确保激活了你的venv虚拟环境，比如：

   source 你的虚拟环境目录/bin/activate
   

   激活成功后，命令行前面会显示虚拟环境的名字，比如(my_venv)。

3. 重新执行依赖安装：

   pip install -r requirements.txt
   

   这次psycopg2就能正常编译安装了，Flask等其他依赖也会一起装到虚拟环境里。

4. 最后再跑数据库迁移命令：

   ./manage.py db upgrade
   

   这时候虚拟环境里所有需要的包都齐了，就不会再报导入错误了。

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