flask的debug=true无效，直接原因是启动方式错误：热重载仅在直接执行python app.py且app.run(debug=true)位于if name == '__main__':内时生效；若通过pycharm“run”按钮、flask run命令（未配flask_debug=1）或被import触发，则reloader静默失效。
Flask开发时改代码不重启服务，为什么debug=True没用？
直接原因通常是启动方式不对。Flask的热重载（reloader）只在调用app.run()且显式传入debug=True时才激活，但前提是不能通过IDE或打包工具间接运行——比如用PyCharm的“Run”按钮、或把app.run()写在模块顶层又被其他脚本import，都会导致reloader静默失效。
常见错误现象：debug=True设了，控制台也显示Debug mode: on，但改完Python文件后服务没自动重启，必须手动Ctrl+C再运行。
- 确认启动入口是直接执行
python app.py，不是通过flask run命令（该命令默认启用reloader，但需额外配置环境变量） - 检查
app.run()是否被包裹在if __name__ == '__main__':里，否则被import时会意外触发 - Windows下若用WSL或某些终端，可能因文件系统监控延迟导致reload滞后，可加
use_reloader=True显式声明（虽是默认值）
flask run命令下如何稳定启用热重载？
官方推荐方式，但默认行为依赖环境变量。flask run本身不读取代码里的debug参数，它只看FLASK_ENV或FLASK_DEBUG。
正确做法是设置环境变量再运行命令：
export FLASK_DEBUG=1 # Linux/macOS set FLASK_DEBUG=1 # Windows cmd flask run
注意：FLASK_ENV=development已弃用（自Flask 2.3起警告），仅FLASK_DEBUG可靠。若用flask run --debug，等价于设FLASK_DEBUG=1，但部分旧版本不支持该flag。
- 确保
FLASK_APP=app.py已设置，否则flask run找不到应用实例 - 如果项目结构含包（如
myapp/__init__.py），FLASK_APP应设为myapp而非myapp/app.py - 某些编辑器（如VS Code）的终端可能不继承系统环境变量，需在launch.json中显式配置env
热重载监听哪些文件？改模板或静态文件为何不生效？
Flask默认只监控.py文件变更触发重启，HTML模板、CSS、JS等静态资源修改不会触发reloader——这是设计使然，不是bug。这类文件通常由浏览器缓存或前端构建工具处理，与后端服务生命周期无关。
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
若你确实需要监听非Python文件（例如Jinja2模板热更新），得手动扩展reloader：
from flask import Flask
app = Flask(__name__)
app.run(
debug=True,
extra_files=['templates/', 'static/'] # 监控整个目录
)
但要注意：extra_files只接受文件路径列表，不支持通配符；目录路径需存在，否则启动报错OSError: [Errno 2] No such file or directory。
- 监听目录时，新增/删除文件也会触发重启，频繁保存可能干扰开发流
- 模板修改后仍需刷新浏览器，reloader只负责重启服务，不自动注入新内容到已打开页面
- 生产环境绝对禁用
extra_files，文件扫描开销大且有安全风险
为什么开了debug模式却看不到详细错误页面？
Flask的调试页面（Interactive Debugger）和热重载是两个独立功能，都依赖debug=True，但后者还要求Werkzeug版本兼容且未被中间件拦截。
典型失败场景：用了gunicorn或nginx前置代理，或代码里调用了app.wsgi_app包装，导致Werkzeug的调试中间件被绕过。
- 纯Flask开发时，只要
debug=True且无异常捕获逻辑（如全局try/except吞掉异常），出错就会显示蓝色调试页 - 若用
flask run启动，必须同时满足FLASK_DEBUG=1和未设置WERKZEUG_RUN_MAIN（该变量由reloader内部设置，手动设会导致调试页消失） - 某些日志库（如Loguru）的异常钩子可能干扰调试页渲染，临时注释相关
enable调用可验证
热重载本身不保证调试页面可用，它只管进程重启；而调试页面能否显示，取决于异常是否透出到Werkzeug顶层。这两件事容易混淆，但排查路径完全不同。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
