Flask Hello World

在开始您的 Flask 之旅前，请确保您的系统已安装 Python 3.7+ 和 pip（Python 的包安装程序）。您可以通过在终端中运行以下命令来检查 Python 版本：

python --version

您应该会看到类似 Python 3.x.x 的输出。如果未找到 Python 或版本过旧，请访问 python.org 下载并安装最新版本。

使用虚拟环境是 Python 项目的最佳实践。它为您的项目依赖项创建了一个独立空间，防止与其它项目或系统范围的 Python 包发生冲突。

首先，在终端中导航到您希望的项目目录。然后，创建一个新的虚拟环境：

python -m venv .venv

接下来，激活您的虚拟环境：

# 在 macOS/Linux 上
source .venv/bin/activate

# 在 Windows 上（使用命令提示符）
.venv\Scripts\activate

# 在 Windows 上（使用 PowerShell）
.venv\Scripts\Activate.ps1

当您在终端提示符前看到 (.venv) 时，就知道您的虚拟环境已激活。

激活虚拟环境后，您现在可以安装 Flask。此命令将把 Flask 及其依赖项下载并安装到您的隔离环境中。

pip install Flask

您应该会看到 Flask 及其依赖项（Werkzeug、Jinja2 等）已成功安装。现在您已准备好编写代码！

现在，让我们为您的“Hello World”应用程序创建 Python 文件。在您的项目目录中，创建一个名为 app.py 的新文件（这是 Flask 寻找的常见约定）。您可以使用任何文本编辑器或 IDE（如 VS Code）。

将以下代码添加到您的 app.py 文件中：

from flask import Flask

# Create a Flask application instance
app = Flask(__name__)

# Define a route for the root URL ("/")
@app.route("/")
def hello_world():
    return "
Hello, World!
"

# This block allows you to run the app directly
# without using the 'flask run' command (optional but common)
if __name__ == "__main__":
    app.run(debug=True)

将文件保存为项目根目录中的 app.py。

让我们分解一下您刚刚编写的 app.py 代码：

• from flask import Flask: 此行从 flask 包中导入 Flask 类。Flask 类将用于创建您的 Web 应用程序实例。
• app = Flask(__name__): 在这里，我们创建了一个 Flask 类的实例。__name__ 是一个特殊的 Python 变量，代表当前模块的名称。Flask 用它来确定应用程序的根路径，这对于定位模板和静态文件等资源至关重要。
• @app.route("/"): 这是一个装饰器。在 Flask 中，装饰器用于将函数绑定到 URL 路径。在这种情况下，它意味着当有人访问您应用程序的根 URL (/) 时，hello_world 函数将被执行。
• def hello_world(): return "<p>Hello, World!</p>": 这是当访问 / 路由时调用的函数。它简单地返回一个包含“Hello, World!”的 HTML 段落标签。Flask 会自动将此字符串渲染为用户浏览器中的响应。
• if __name__ == "__main__": app.run(debug=True): 此代码块确保开发服务器仅在脚本直接执行时运行（而不是作为模块导入时）。app.run() 启动 Flask 开发服务器，debug=True 启用调试模式，这会提供有用的错误消息并在代码更改时自动重新加载服务器。

现在您的 app.py 文件已准备就绪，您可以从终端运行您的 Flask 应用程序。确保您的虚拟环境仍处于激活状态！

运行 Flask 应用程序有两种常见方式：

方法 1：使用 Flask CLI（推荐用于开发）

Flask 命令行界面 (CLI) 是运行开发服务器的首选方式。首先，通过设置 FLASK_APP 环境变量来告诉 Flask 您的应用程序位于何处：

# 在 macOS/Linux 上
export FLASK_APP=app.py
flask run

# 在 Windows 上（命令提示符）
set FLASK_APP=app.py
flask run

# 在 Windows 上（使用 PowerShell）
$env:FLASK_APP="app.py"
flask run

方法 2：直接运行 Python 文件

如果您在 app.py 中包含了 if __name__ == "__main__": app.run() 代码块（如第 5 步所示），您可以像运行任何其他 Python 脚本一样简单地运行它：

python app.py

运行后，您应该会看到输出，表明 Flask 开发服务器正在运行，通常在 http://127.0.0.1:5000/ 上。

您的 Flask 应用程序现在正在运行！要查看其效果，请打开您的网页浏览器并导航到终端输出中提供的地址：

🔗 http://127.0.0.1:5000/

您应该会看到一个显示以下文本的页面：

恭喜！您已成功创建并运行了您的第一个 Flask “Hello World”应用程序！

Flask 的调试模式在开发过程中非常有用。它提供两个主要好处：

• 自动重载： 当您更改代码时，服务器将自动重新加载。
• 交互式调试器： 如果发生错误，浏览器中会出现一个交互式调试器，允许您检查变量和追溯。

如果您在第 5 步中使用了 `app.run(debug=True)` 方法，调试模式已经激活。如果您正在使用 Flask CLI (`flask run`)，可以通过设置环境变量来激活调试模式：

# 在 macOS/Linux 上
export FLASK_ENV=development
flask run

# 在 Windows 上（命令提示符）
set FLASK_ENV=development
flask run

# 在 Windows 上（使用 PowerShell）
$env:FLASK_ENV="development"
flask run

您会在终端中看到类似“Debugger is active!”的消息，确认调试模式已启用。请记住，出于安全原因，在生产环境中禁用调试模式。

路由是 Flask 将 URL 映射到 Python 函数的方式。您已经使用过 @app.route("/")。让我们向您的 app.py 文件添加另一个路由。

修改您的 app.py 以包含一个新路由，例如 /greet/<name>：

from flask import Flask

app = Flask(__name__)

@app.route("/")
def hello_world():
    return "
Hello, World!
"

@app.route("/greet/<name>")
def greet(name):
    return f"
Hello, {name.capitalize()}!
"

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

保存文件。如果调试模式已激活，您的服务器将自动重新加载。现在，在浏览器中访问 http://127.0.0.1:5000/greet/Alice。您应该会看到“Hello, Alice!”。

路由中的 <name> 作为 URL 的可变部分，然后作为参数传递给您的 greet() 函数。这允许您创建动态路由。

您已成功构建并运行了您的第一个 Flask 应用程序！这只是一个开始。Flask 还有更多值得探索的地方：

• 使用 Jinja2 模板： 学习使用 Jinja2 模板来替代返回 HTML 字符串，以创建更复杂、更易维护的用户界面。
• 静态文件： 提供 CSS、JavaScript 和图片，使您的应用程序具有视觉吸引力。
• 表单： 使用 Flask-WTF 或自定义表单处理用户输入。
• 数据库： 与 SQL（例如，使用 SQLAlchemy 的 SQLite、PostgreSQL）或 NoSQL 数据库集成。
• 蓝图 (Blueprints)： 将您的应用程序组织成更小、可重用的组件，适用于大型项目。
• 扩展： 探索 Flask 扩展的丰富生态系统，以实现身份验证 (Flask-Login)、REST API (Flask-RESTful) 等功能。
• 部署： 学习如何将您的 Flask 应用程序部署到生产服务器（例如，Gunicorn、Nginx、Docker）。

继续尝试，阅读官方 Flask 文档，并构建小型项目。编程愉快！