Flask应用已安装wtforms、flask_wtf但导入无法解析求助

你已经完成的pip版本核查、site-packages目录核查步骤，已经可以完全排除依赖本身的安装问题，这类黄色波浪线导入报错基本都是IDE静态检查配置异常导致的，按以下步骤逐一排查即可：

• 切换IDE绑定的Python解释器到当前项目虚拟环境
  90%以上的这类问题都是IDE默认选了全局Python解释器，根本没读取到你虚拟环境里装的包。VS Code直接点右下角状态栏的Python版本号，在弹出的解释器列表里选虚拟环境路径下的可执行文件：Windows环境选env\Scripts\python.exe，Mac/Linux环境选env/bin/python，别选全局Python、conda环境或者其他项目的虚拟环境。PyCharm用户去File -> Settings -> Project -> Python Interpreter页面，点齿轮图标选Add Existing Virtual Environment，选中对应虚拟环境的python可执行文件就行。
• 强制刷新IDE的依赖索引缓存
  选对解释器后如果还有黄色波浪线，是IDE的语言服务缓存没更新。VS Code按快捷键Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac）调出命令面板，执行Python: Restart Language Server命令，等10到30秒让语言服务重新扫描site-packages下的依赖就好。PyCharm用户点File -> Invalidate Caches，弹窗里勾选所有缓存清除选项，点Invalidate and Restart等IDE重启重建索引。
• 替换存在识别兼容问题的开发版依赖
  你site-packages目录下的Flask_WTF是1.1.0dev0开发版，用egg-info格式打包，不少Python语言服务对开发版egg包的识别有已知bug。执行下面的命令卸载开发版，装正式稳定版：

  py -m pip uninstall flask-wtf -y
  py -m pip install flask-wtf==1.1.2
  

  装完重启IDE就能消掉报错。
• 排除IDE静态检查误报
  别把IDE的波浪线当成导入是否成功的唯一判断标准，激活虚拟环境后在终端执行下面的命令验证实际导入状态：

  py -c "from flask_wtf import FlaskForm; from wtforms import StringField; print('导入验证通过')"
  

  如果终端执行完输出“导入验证通过”，没有抛ModuleNotFoundError，说明依赖完全可用，波浪线只是IDE静态检查的误报，不影响项目实际运行。

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