### 解决 Python 中导入 SQLAlchemy 模块未找到错误 当遇到 `No module named 'sqlalchemy'` 错误时，表明当前环境中尚未安装 SQLAlchemy 库。要解决此问题，需确保正确安装了 SQLAlchemy 及其依赖项。 #### 1. 安装 SQLAlchemy 和 PyMySQL 首先确认已安装最新版的 SQLAlchemy： ```bash pip install --upgrade sqlalchemy ``` 由于 MySQLdb 不适用于 Python 3.x 版本，在使用 MySQL 数据库时推荐采用 PyMySQL 驱动程序作为替代方案： ```bash pip install pymysql ``` #### 2. 修改数据库 URI 字符串配置 对于 Flask-SQLAlchemy 用户来说，应调整应用中的数据库连接 URL 设置，显式指明所使用的驱动器名称为 `pymysql`: ```python import os from flask import Flask from flask_sqlalchemy import SQLAlchemy app = Flask(__name__) # 使用 mysql+pymysql 方式来指定驱动 app.config['SQLALCHEMY_DATABASE_URI'] = f"mysql+pymysql://{os.getenv('DB_USER')}:{os.getenv('DB_PASSWORD')}@{os.getenv('DB_HOST')}/{os.getenv('DB_NAME')}" db = SQLAlchemy(app) ``` 通过上述更改可以有效规避因默认加载 MySQLdb 所引发的相关异常[^2]。 #### 3. 测试 SQLAlchemy 是否正常工作 创建简单的测试脚本来验证 SQLAlchemy 已经成功集成到项目当中： ```python from sqlalchemy import create_engine, Column, Integer, String from sqlalchemy.ext.declarative import declarative_base from sqlalchemy.orm import sessionmaker Base = declarative_base() class User(Base): __tablename__ = 'users' id = Column(Integer, primary_key=True) name = Column(String) engine = create_engine(f'mysql+pymysql://root:password@localhost/test_db') Session = sessionmaker(bind=engine) session = Session() new_user = User(name='test user') session.add(new_user) session.commit() print("Database connection and SQLAlchemy setup successful.") ``` 如果以上代码能够顺利执行，则说明 SQLAlchemy 的安装与配置均无误。