运行flask run报No module named 'hello' 重建环境仍报错
报错根因说明
该报错和Flask运行时代码缓存无关,核心原因是残留的环境变量、全局/本地CLI配置没有被常规清理操作覆盖。你此前执行的删除__pycache__、清理conda/pip缓存、重建虚拟环境的操作,均无法清除存储在shell配置文件、用户家目录隐藏路径、项目隐藏配置文件中的旧路径指向,这些配置会强制Flask CLI尝试导入已被删除的hello模块。
分步解决方案
- 清除残留的
FLASK_APP环境变量- 在当前终端执行
echo $FLASK_APP,如果输出值为hello,直接执行unset FLASK_APP清除当前会话的旧配置 - 逐行检查
~/.bashrc、~/.zshrc、~/.bash_profile、~/.profile文件,删除所有类似export FLASK_APP=xxx的旧配置行,保存后执行source 对应配置文件路径让配置生效,避免新开终端时自动加载旧值 - 检查重建后的myenv虚拟环境激活脚本(路径为
/home/bhojendra/anaconda3/envs/myenv/bin/activate),删除脚本中导出FLASK_APP的残留行
- 在当前终端执行
- 清除Flask全局用户缓存配置
- 执行
rm -rf ~/.flask删除家目录下存储的Flask CLI全局配置,该目录会缓存用户历史指定的APP路径,不受虚拟环境重建影响
- 执行
- 检查项目目录下的本地配置文件残留
- 在正式项目根目录执行
ls -la,查看是否存在.flaskenv、.env隐藏文件 - 打开上述文件,删除所有指向
hello模块的FLASK_APP配置行;如果这类文件不属于正式项目的原有配置,可直接删除
- 在正式项目根目录执行
- 排查IDE运行配置残留
- 如果通过VSCode、PyCharm等编辑器启动项目,需要查看编辑器自带的运行/调试配置,删除所有关联旧hello项目的启动项,重新基于正式项目创建启动配置,避免编辑器传入旧的
FLASK_APP=hello参数
- 如果通过VSCode、PyCharm等编辑器启动项目,需要查看编辑器自带的运行/调试配置,删除所有关联旧hello项目的启动项,重新基于正式项目创建启动配置,避免编辑器传入旧的
- 手动指定启动参数绕开残留配置
- 在正式项目根目录,手动指定实际的Flask应用实例路径启动。例如项目入口为
app.py、实例名为app时,执行命令flask --app app:app run,该操作会强制覆盖所有旧的自动加载配置,不会再尝试导入不存在的hello模块
- 在正式项目根目录,手动指定实际的Flask应用实例路径启动。例如项目入口为
内容的提问来源于stack exchange,提问作者Bhojendra Rauniyar
相关产品推荐
相关产品推荐

