ModuleNotFoundError: No module named ‘flask_sqlalchemy‘

这个错误 ModuleNotFoundError: No module named 'flask_sqlalchemy' 表示你的 Python 环境中没有安装 Flask-SQLAlchemy 这个模块。Flask-SQLAlchemy 是一个流行的 Python 库，它是 Flask 框架的扩展，用于简化与数据库的交互（基于 SQLAlchemy ORM）。

问题原因

你的代码试图导入 flask_sqlalchemy，但因为它尚未安装，Python 找不到这个模块。

解决方法

你需要安装 Flask-SQLAlchemy。以下是具体步骤：

1. 安装 Flask-SQLAlchemy

根据你的环境（全局 Python 或虚拟环境），使用以下命令：

• 使用 pip：

  bash

  pip install Flask-SQLAlchemy

• 使用 conda（如果你用的是 Conda 环境）：

  bash

  conda install -c conda-forge flask-sqlalchemy

2. 确保在正确环境中安装

• 如果你用的是虚拟环境（比如 venv 或 Conda），先激活环境：

  • venv：

    bash

    # Linux/Mac
    source path/to/venv/bin/activate
    
    # Windows
    path\to\venv\Scripts\activate

  • Conda：

    bash

    conda activate your_env_name

• 然后再运行安装命令。

3. 验证安装

安装完成后，检查是否成功：

python

import flask_sqlalchemy
print(flask_sqlalchemy.__version__)

如果没有报错并输出版本号（比如 3.0.3），说明安装成功。

4. 检查代码

确保你的代码中导入语句是正确的：

python

from flask_sqlalchemy import SQLAlchemy

• 注意：模块名是 flask_sqlalchemy（安装时用连字符），但导入时用 flask_sqlalchemy（下划线），这是 Python 的命名规范。

示例代码

安装后，一个简单的 Flask-SQLAlchemy 使用示例：

python

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///test.db'  # 使用 SQLite 数据库
db = SQLAlchemy(app)

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)

if __name__ == '__main__':
    with app.app_context():
        db.create_all()  # 创建数据库表
    app.run(debug=True)

注意事项

• 依赖 SQLAlchemy：安装 Flask-SQLAlchemy 时会自动安装 SQLAlchemy，无需单独安装。

• 数据库驱动：如果你用的是 MySQL 或 PostgreSQL，需要额外的驱动，比如：

  • MySQL：pip install pymysql

  • PostgreSQL：pip install psycopg2

• 拼写错误：确保没有把 flask_sqlalchemy 写成 flask-sqlalchemy 或其他错误形式。

如果仍然报错

• 环境问题：确认你在正确的虚拟环境中安装（用 pip list 查看已安装的包）。

• 版本冲突：尝试升级 pip 或指定版本：

  bash

  pip install --upgrade pip
  pip install Flask-SQLAlchemy==3.0.3

• 网络问题：安装失败时，换个源试试：

  bash

  pip install Flask-SQLAlchemy -i https://pypi.tuna.tsinghua.edu.cn/simple