已安装flask-sqlalchemy仍报ModuleNotFoundError（macOS环境）

以下是针对macOS系统的实用排查步骤：

• 确认Python与pip版本匹配
  macOS自带Python2，新手通常安装的是Python3，两者的包管理工具是分开的：

  • 查看当前Python版本：

    python --version  # 对应系统自带Python2
    python3 --version # 你安装的Python3版本
    

  • 若使用Python3，必须用pip3安装库：

    pip3 install flask-sqlalchemy
    

• 验证库是否安装在正确环境
  运行命令查看已安装的包列表，确认Flask-SQLAlchemy存在：

  python3 -m pip list
  

  运行代码时要对应使用python3：

  python3 你的脚本文件名.py
  

• 虚拟环境排查（新手高频坑）
  如果使用了虚拟环境，必须激活环境后再操作：

  1. 创建并激活虚拟环境：

     python3 -m venv venv
     source venv/bin/activate
     

     激活后命令行开头会显示(venv)标识
  2. 在激活的环境中安装库：

     pip install flask-sqlalchemy
     

  3. 运行代码：

     python 你的脚本文件名.py
     

• 检查Python路径冲突
  查看Python和pip的路径，确保两者属于同一个环境：

  which python3
  which pip3
  

  正常情况下，两个路径应该一致（比如都在/usr/local/bin/或虚拟环境的venv/bin/目录下）

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