Flask 在开发中修改代码后页面未更新，通常是因为未正确启用热重载机制——关键在于必须直接运行 main.py（含 app.run(debug=True)），而非通过 VS Code 的调试器或终端误启了旧进程、缓存服务或错误入口文件。
flask 在开发中修改代码后页面未更新，通常是因为未正确启用热重载机制——关键在于必须直接运行 `main.py`（含 `app.run(debug=true)`），而非通过 vs code 的调试器或终端误启了旧进程、缓存服务或错误入口文件。
你遇到的问题——修改路由（如将 @auth.route('/SignUp') 改为 @auth.route('/signup')）或视图返回内容后，浏览器仍显示旧结果，甚至旧路径（如 /SignUp）仍能访问而新路径（/signup）404——这并非 Flask 热重载失效，而是应用实际运行的并非你最新修改的代码版本。
根本原因在于：你当前可能正运行着一个残留的旧 Flask 进程，或 VS Code 以非预期方式（例如通过 Python 调试器启动了 __init__.py 或其他模块）执行了旧缓存实例。debug=True 仅在 由 app.run() 主动启动且无其他进程干扰时 才触发自动重载；若后台已有 flask run、python -m flask 或旧 main.py 实例在运行，新修改不会生效。
✅ 正确操作步骤如下：
-
彻底终止所有 Flask 进程
在终端中执行：# Linux/macOS pkill -f "flask\|main.py" # Windows（PowerShell） Get-Process | Where-Object {$_.CommandLine -match "flask|main.py"} | Stop-Process -
确保只通过
main.py启动
在项目根目录（即main.py所在目录）下，使用以下命令运行：python main.py
✅ 此时控制台应显示：
* Debug mode: on * Running on http://127.0.0.1:5000 * Restarting with stat ← 表明热重载已激活 * Debugger is active!
-
验证热重载是否生效
修改auth.py中的sign_up()函数：@auth.route('/signup') def sign_up(): return "<p>✅ New Signup Page (v2)</p>" # 修改此处保存后，刷新
http://127.0.0.1/signup—— 页面应立即更新，终端日志中会出现* Detected change in .../auth.py, reloading。
⚠️ 注意事项：
- 不要混用
flask run和python main.py：flask run依赖环境变量（如FLASK_APP），易绕过main.py中的create_app()配置，导致debug=True和TEMPLATES_AUTO_RELOAD失效； - VS Code 中请检查「运行配置」：确保
launch.json的"module"或"program"指向main.py，而非website/__init__.py； - 浏览器端强制刷新（
Ctrl+Shift+R/Cmd+Shift+R）可排除静态资源缓存干扰； -
app.config['SEND_FILE_MAX_AGE_DEFAULT'] = 0对模板和路由逻辑无影响，它仅作用于send_file()等静态文件响应，无需在开发中设置。
总结：Flask 的热重载不是“魔法”，它依赖单一、干净、由 app.run(debug=True) 驱动的主进程。每次修改后，请确认终端中运行的是你刚保存的 main.py，并留意控制台是否打印 Restarting with stat —— 这才是热更新真正就绪的唯一可靠信号。
