运行Flask旧应用遇ModuleNotFoundError：找不到wtforms.ext模块

问题根源 #

wtforms.ext 是WTForms旧版本（2.0之前）的内置扩展模块，新版本WTForms（2.0及以上）已弃用该结构，将各类扩展拆分到独立包中，因此直接安装最新版WTForms或相关包无法解决问题。

解决思路 #

• 安装兼容旧版的WTForms
  直接安装2.0之前的WTForms版本（完整保留wtforms.ext模块），比如指定1.0.5版本：

  python3 -m pip install wtforms==1.0.5
  

  若不确定具体适配版本，也可尝试2.0.x之前的最高版本，如wtforms==1.5.5。

• 替换扩展模块（可选，适合代码升级）
  若愿意修改旧应用代码，可将wtforms.ext相关导入替换为对应独立包：

  • 例如原导入from wtforms.ext.sqlalchemy.fields import QuerySelectField，改为from wtforms_sqlalchemy.fields import QuerySelectField，同时安装对应独立包：

    pip install wtforms-sqlalchemy
    

  • 其他wtforms.ext子模块也有对应独立包（如wtforms-dateutil对应wtforms.ext.dateutil），按需安装即可。

• 使用虚拟环境隔离依赖
  避免全局包版本冲突，创建并激活虚拟环境后再安装指定版本：

  # 创建虚拟环境
  python3 -m venv flask-env
  # Linux/macOS激活
  source flask-env/bin/activate
  # Windows激活
  flask-env\Scripts\activate
  # 安装依赖
  pip install wtforms==1.0.5 flask flask-wtf
  

• 检查应用的requirements文件
  如果旧应用提供了requirements.txt或setup.py，直接执行以下命令安装指定版本依赖，可最大程度避免版本不兼容：

  pip install -r requirements.txt
  

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