开发服务器

Flask 提供了一个 run 命令，该命令用来以开发服务器运行应用。在开发模式下，开发服务器提供交互式调试器，并在代码更改时重新加载。

Warning

生产环境不要使用开发服务器。开发服务器仅供在本地开发期间使用，它在效率、稳定或安全方面是缺失的。

有关部署选项，请参阅部署方式。

通过命令行使用开发服务器

推荐使用 flask run 命令行脚本运行开发服务器。这需要设置 FLASK_APP 环境变量指向您的应用，且设置 FLASK_ENV=development ，以用于启用开发模式。

BashCMDPowershell

$ export FLASK_APP=hello
$ export FLASK_ENV=development
$ flask run

> set FLASK_APP=hello
> set FLASK_ENV=development
> flask run

> $env:FLASK_APP = "hello"
> $env:FLASK_ENV = "development"
> flask run

这样就启动了开发环境，包括交互调试器和重载器，并在 http://localhost:5000/ 提供服务。使用 flask run --help 命令可以查看可用的选项，命令行接口提供了关于配置和使用 CLI 的详细介绍。

Note

Flask 1.0 版之前， FLASK_ENV 环境变量是不可用的，您需要导出 FLASK_DEBUG=1 来开启调试模式。这样做仍能控制调试模式的开关，但是推荐使用前述的方法。

当重加载器使用 flask run 命令时，服务器将持续运行。哪怕您在代码中引入了语法错误或其他初始化错误。访问网站时会交互式调试器中显示错误，而不是使服务器崩溃。此功能称为“延迟加载”。

如果在调用 flask run 时已经存在语法错误，它将立即失败并显示回溯，而不是等到网站被访问。这是为了使错误最初更明显同时仍然允许服务器在重新加载时处理错误。

要覆盖此行为并始终立即失败，即使在重新加载时，应当传递 --eager-loading 参数。要始终保持服务器运行，即使在最初的调用中，传递 --lazy-loading 参数。

另一种方法是在 Python 中通过 Flask.run() 方法启动应用。这个方法接受的参数与 CLI 的相似。主要的不同是重新加载时如果有错误，服务器会崩溃。

debug=True 参数可以开启调试器和重载器，但是要开启开发模式仍需要设置 FLASK_ENV=development 环境变量。

应当把调用放在 main 代码块中，否则当以后在生产环境中导入和运行应用时会产生干扰。

if __name__ == "__main__":
    app.run(debug=True)

$ python hello.py