HOWTO · Flask
运行 Flask 应用程序
设置 Python 虚拟环境，安装 Flask，创建一个小型 app.py 应用程序，并在本地运行。
本页内容
要运行 Flask 应用，请先创建 Python 虚拟环境并在其中安装 Flask，然后将路由保存到 app.py，再通过 Flask 命令行界面启动开发服务器。在浏览器中打开服务器打印的本地地址，即可查看路由的响应。本指南使用 Visual Studio Code；使用其他编辑器时，文件和命令也相同。
创建一个基本的 Flask 应用程序
Flask 是一个用于构建 Web 应用和 API 的 Python Web 框架。一个小型项目需要 Python、安装在项目环境中的 Flask，以及一个定义应用和路由的 Python 文件。
首先，在 Visual Studio Code 中打开项目文件夹，然后在集成终端中运行 python --version，检查是否可以使用 Python。该命令应打印已安装的 Python 版本。在某些系统中，Python 命令名为 python3；如有需要，请在检查版本、创建环境和后续运行命令时统一使用该名称。
在项目文件夹中运行 python -m venv .venv 来创建虚拟环境。虚拟环境会将此项目的软件包与其他 Python 项目及系统安装隔离。请根据所用终端运行相应的激活命令：
- Windows 命令提示符：
.venv\\Scripts\\activate.bat - Windows PowerShell：
.venv\\Scripts\\Activate.ps1 - macOS 或 Linux：
source .venv/bin/activate
激活环境后，运行 python -m pip install Flask 安装 Flask。使用 python -m pip 可确保将软件包安装到当前活动环境所选用的 Python 解释器中。如果终端提示找不到 python，并且系统提供了 python3，请改用它重复这些命令。在 Visual Studio Code 未自动识别环境时，请选择 .venv 解释器。
在项目文件夹中创建名为 app.py 的文件，并添加下面这个最简应用。运行 python app.py 时，它的测试客户端会请求根路由并打印响应：
from flask import Flask
app = Flask(__name__)
@app.route("/")
def index():
return "Hi there, this is our basic Flask app."
if __name__ == "__main__":
response = app.test_client().get("/")
print(response.get_data(as_text=True))
Hi there, this is our basic Flask app.
Flask 类用于创建应用对象。@app.route("/") 装饰器会将网站的根路径映射到 index，函数返回的字符串则会成为浏览器收到的响应。测试客户端可以在不打开网络端口的情况下调用该路由。只有直接运行此文件时，if __name__ == "__main__": 代码块才会执行检查；从其他模块导入该文件不会打印响应。
若要在浏览器中查看应用，请保持虚拟环境处于活动状态，并确保终端位于包含 app.py 的文件夹中，然后运行 Flask 开发服务器命令 flask --app app run。如果系统使用 python3，请激活使用该解释器创建的环境，并使用对应的 Flask 命令。Flask 会打印一个本地 URL，通常是 http://127.0.0.1:5000；请打开终端中显示的完整地址。访问根路径时，页面会显示 Hi there, this is our basic Flask app.。示例中的响应文字保持英文。浏览页面期间请让终端中的服务器进程持续运行；要停止服务器，请在该终端中按 Ctrl+C。运行 python app.py 则会执行上面的路由检查并退出。
Flask 内置服务器仅供本地开发使用。请勿将它作为生产服务器对外开放，也不要在生产部署中启用调试模式；应根据主机环境使用合适的生产级 WSGI 服务器和部署配置。
