求助解决ModuleNotFoundError: No module named 'flask_sqlalchemy'错误

• 确认虚拟环境激活状态
  运行项目前必须确保.venv已激活，否则会默认使用系统全局Python环境：

  • Windows终端执行：.\.venv\Scripts\activate
  • macOS/Linux终端执行：source ./.venv/bin/activate
    激活后终端前缀会显示(.venv)，此时运行pip list，检查Flask-SQLAlchemy是否在依赖列表中，版本是否与requirements.txt一致。

• 检查requirements.txt依赖格式
  确保requirements.txt中依赖名称为flask-sqlalchemy（小写连字符，而非下划线），示例正确格式：

  Flask==2.3.3
  Flask-Smorest==0.41.0
  flask-sqlalchemy==3.1.1
  

  执行pip install -r requirements.txt后，再次用pip list验证依赖是否安装成功。

• Docker环境的依赖安装验证

  1. 检查Dockerfile是否正确执行依赖安装，且命令在复制requirements.txt之后（避免缓存导致依赖未更新）：

     FROM python:3.11-slim
     WORKDIR /app
     COPY requirements.txt .
     RUN pip install --no-cache-dir -r requirements.txt
     COPY . .
     CMD ["python", "app.py"]
     

  2. 进入运行中的Docker容器验证依赖：

     docker exec -it <容器ID/名称> bash
     pip list | grep flask-sqlalchemy
     

     若未找到依赖，重新构建镜像时禁用缓存：docker build --no-cache -t your-image-name .

• 检查IDE的Python解释器配置
  如果使用IDE（如VS Code）运行项目，确认IDE选择的是.venv内的Python解释器，而非系统全局Python。可在IDE的Python解释器选择界面，切换到.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows）。

• 验证代码导入语句
  代码中导入时需使用from flask_sqlalchemy import SQLAlchemy（下划线格式），这是正确的包导入名，与安装时的flask-sqlalchemy（连字符）为对应关系，不要混淆格式。

• 重置虚拟环境
  若多次重装依赖仍无效，删除.venv文件夹后重新创建：

  # macOS/Linux
  rm -rf .venv
  python -m venv .venv
  source ./.venv/bin/activate
  pip install -r requirements.txt
  
  # Windows
  rmdir /s .venv
  python -m venv .venv
  .\.venv\Scripts\activate
  pip install -r requirements.txt
  

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