Flask 开发时代码修改不生效？正确重启服务器的方法详解-Python教程-PHP中文网

Flask 开发时代码修改不生效？正确重启服务器的方法详解

Flask 应用修改路由或视图后页面未更新，通常是因为 VS Code 中误用了错误的启动方式（如仅运行 main.py 而未真正重启 Flask 开发服务器），导致旧进程仍在运行；需确保每次修改后通过终端手动重启 flask run 或正确配置热重载。

flask 应用修改路由或视图后页面未更新，通常是因为 vs code 中误用了错误的启动方式（如仅运行 `main.py` 而未真正重启 flask 开发服务器），导致旧进程仍在运行；需确保每次修改后通过终端手动重启 `flask run` 或正确配置热重载。

你遇到的问题——修改 @auth.route('/signup') 后访问 /signup 仍返回旧内容，甚至旧路径 /SignUp（已删除）反而“还能访问”——根本原因不是 Flask 配置失效，而是开发服务器进程未真正重启。

在你的项目结构中：

main.py 位于 website/ 外层，负责调用 create_app() 并执行 app.run(debug=True)
website/__init__.py 中创建了 Flask 实例并注册蓝图
所有路由定义在 views.py 和 auth.py 中

看似 debug=True 应该自动热重载，但关键陷阱在于：VS Code 的「Run Python File in Terminal」（右键 → Run Python File）默认执行的是 python main.py，而非 Flask 官方推荐的 flask run 命令。这会导致两个严重问题：

app.run(debug=True) 在非主模块中启动时，Flask 的重载器（reloader）可能无法监控子包（如 website.views）的文件变更；
更重要的是：VS Code 的 Python 运行器不会自动终止前一个 main.py 进程——你多次点击运行，实际是累积启动了多个 Flask 实例（端口被占用时会报错，但若端口释放不彻底，旧进程可能静默残留），浏览器请求被转发到旧进程，因此看到“已删除的路由仍能访问”。

✅ 正确做法（推荐）：

在项目根目录（即包含 main.py 的目录）打开终端，显式使用 Flask CLI 启动，并启用重载：

# 确保设置环境变量（Windows）
set FLASK_APP=main.py
set FLASK_ENV=development
# 或 Linux/macOS
export FLASK_APP=main.py
export FLASK_ENV=development

flask run --reload

⚠️ 注意：FLASK_ENV=development（已替代过时的 debug=True 参数）会自动启用重载器，并递归监听整个 website/ 包下的所有 .py 文件变更。

? 补充优化（提升可靠性）：

在 main.py 顶部添加：

import os
os.environ.setdefault('FLASK_APP', 'main.py')
os.environ.setdefault('FLASK_ENV', 'development')

VS Code 中可配置 launch.json 使用 flask run 而非 python main.py：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flask: Run",
      "type": "python",
      "request": "launch",
      "module": "flask",
      "args": ["run", "--reload"],
      "env": {
        "FLASK_APP": "main.py",
        "FLASK_ENV": "development"
      }
    }
  ]
}

? 总结：
不要依赖 VS Code 右键「Run Python File」来启动 Flask；务必使用 flask run --reload 并正确设置 FLASK_APP。app.run(debug=True) 仅适用于最简脚本场景，在蓝图为架构的模块化项目中，Flask CLI 是唯一可靠的选择。每次修改代码后，保存文件，终端将自动检测变更并重启服务——此时 /signup 才会生效，而 /SignUp 将彻底 404。