Flask应用启动报ModuleNotFoundError，无法找到已安装模块求助

1. 安装缺失的pymysql依赖 #

• 打开终端/命令行，激活你的项目虚拟环境（如果已创建），执行：

  pip install pymysql
  

• 把pymysql添加到requirements.txt中，避免后续部署或重新安装时遗漏：

  Flask
  flask_login
  Flask-SQLAlchemy
  pymysql
  

2. 验证PyCharm的Python解释器配置 #

• 打开PyCharm的设置（Windows：File → Settings；macOS：PyCharm → Settings）
• 导航到Project: <你的项目名称> → Python Interpreter
• 确认选中的解释器是项目对应的虚拟环境解释器（路径一般是项目根目录下的venv/bin/python（macOS）或venv\Scripts\python.exe（Windows））
• 在已安装包列表中检查pymysql和Flask-SQLAlchemy是否存在，若缺失，点击右上角的+按钮，搜索并安装这两个包

3. 确认数据库连接字符串格式 #

确保Flask配置中的数据库URI正确指定了pymysql驱动，格式如下：

app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://用户名:密码@localhost/数据库名'

注意必须包含+pymysql后缀，否则SQLAlchemy会尝试使用默认驱动而非pymysql。

4. 虚拟环境基础配置（针对不熟悉虚拟环境的用户） #

如果还未创建项目虚拟环境，按以下步骤操作：

• 创建虚拟环境：

  # Windows
  py -m venv venv
  # macOS/Linux
  python3 -m venv venv
  

• 激活虚拟环境：

  # Windows
  venv\Scripts\activate
  # macOS/Linux
  source venv/bin/activate
  

• 激活后安装所有依赖：

  pip install -r requirements.txt
  

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