本教程详细介绍了如何在 flask 应用中实现 html 页面间的导航。通过定义不同的路由（`@app.route`）来渲染对应的 html 模板（`render_template`），并利用 html 中的超链接（`` 标签）在页面间进行跳转。文章涵盖了初始页面加载、导航链接创建以及目标页面渲染的核心步骤，并探讨了在处理不同 http 请求方法时的考量，旨在帮助开发者构建结构清晰、交互流畅的 flask web 应用。
在开发基于 Flask 的 Web 应用程序时，用户在不同 HTML 页面之间进行导航是一个基本且常见的需求。这通常涉及到一个页面包含指向另一个页面的链接或按钮，当用户点击时，Flask 后端会根据请求的 URL 渲染并返回相应的 HTML 页面。本教程将指导您如何通过 Flask 的路由机制和模板渲染功能来实现这一过程。
核心概念：Flask 路由与模板渲染
Flask 框架通过路由（Routes）来匹配传入的 URL 请求，并将其映射到特定的 Python 函数。这些函数负责处理请求并返回响应，常见的响应类型包括 HTML 页面、JSON 数据等。当需要返回 HTML 页面时，Flask 提供了 render_template 函数，它可以加载并渲染位于 templates 目录下的 HTML 文件。
- @app.route('/path'): 这是一个装饰器，用于将 URL 路径 /path 绑定到紧随其后的函数。当用户访问 /path 时，该函数将被执行。
- render_template("filename.html"): 此函数用于查找并渲染指定名称的 HTML 模板文件。Flask 默认会在应用程序根目录下的 templates 文件夹中寻找这些文件。
实现步骤
我们将通过一个简单的示例来演示如何从一个 HTML 页面导航到另一个 HTML 页面。
1. 项目结构准备
首先，确保您的 Flask 项目具有以下基本结构：
立即学习“前端免费学习笔记（深入）”；
your_project/
├── app.py
└── templates/
├── index.html
└── another_file.html在 templates 文件夹中，我们将存放所有的 HTML 模板文件。
2. 定义初始页面路由
在 app.py 中，我们需要定义一个路由来处理应用的根 URL (/)，并渲染我们的起始页面 index.html。
from flask import Flask, render_template, request
app = Flask(__name__)
@app.route('/')
def index():
"""
渲染应用的首页。
"""
return render_template("index.html")
if __name__ == '__main__':
app.run(debug=True)此时，当您运行 app.py 并访问 http://127.0.0.1:5000/ 时，Flask 将会查找并渲染 templates/index.html。
3. 创建导航链接
接下来，在 index.html 中添加一个超链接，用于导航到第二个页面。例如，一个“注册”按钮或链接。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>首页</title>
</head>
<body>
<h1>欢迎来到首页！</h1>
<p>点击下方链接进入注册页面：</p>
<!-- 使用 href 属性指向目标路由 -->
<a href="https://www.php.cn/link/3db893ff5d6c0e9dccfed451a741853f">注册</a>
</body>
</html>这里，注册 创建了一个链接。当用户点击“注册”时，浏览器将向 Flask 应用发送一个针对 https://www.php.cn/link/3db893ff5d6c0e9dccfed451a741853f URL 的 GET 请求。
4. 定义目标页面路由
最后，在 app.py 中定义另一个路由 https://www.php.cn/link/3db893ff5d6c0e9dccfed451a741853f，它将处理来自 index.html 的导航请求，并渲染 another_file.html。
from flask import Flask, render_template, request
app = Flask(__name__)
@app.route('/')
def index():
"""
渲染应用的首页。
"""
return render_template("index.html")
@app.route('https://www.php.cn/link/3db893ff5d6c0e9dccfed451a741853f', methods=['GET']) # 明确指定只处理 GET 请求
def register():
"""
渲染注册页面。
"""
# 确保用户是通过 GET 请求访问此路径，例如点击链接
if request.method == "GET":
return render_template("another_file.html")
# 如果未来需要处理 POST 请求（例如表单提交），可以在此处扩展
# else:
# pass # 或者处理 POST 请求的逻辑
if __name__ == '__main__':
app.run(debug=True)同时，创建 templates/another_file.html：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>注册页面</title>
</head>
<body>
<h1>欢迎来到注册页面！</h1>
<p>您已成功导航到此页面。</p>
<a href="/">返回首页</a>
</body>
</html>现在，运行 app.py，访问首页，点击“注册”链接，您将被成功导航到注册页面。
考虑 HTTP 方法
在 register 路由中，我们使用了 methods=['GET'] 和 if request.method == "GET" 来明确指定该路由主要处理 GET 请求。这是因为简单的页面导航通常通过 GET 请求完成。然而，如果 https://www.php.cn/link/3db893ff5d6c0e9dccfed451a741853f 页面还包含一个注册表单，用户提交表单时通常会发送 POST 请求。在这种情况下，您可以扩展 register 函数来处理 POST 请求，例如：
from flask import Flask, render_template, request, redirect, url_for
app = Flask(__name__)
# ... 其他路由 ...
@app.route('https://www.php.cn/link/3db893ff5d6c0e9dccfed451a741853f', methods=['GET', 'POST'])
def register():
if request.method == "POST":
# 处理表单提交逻辑
username = request.form.get('username')
password = request.form.get('password')
# ... 保存用户信息到数据库 ...
print(f"用户 {username} 尝试注册")
return redirect(url_for('index')) # 注册成功后重定向到首页
else: # GET 请求
return render_template("another_file.html")通过这种方式，同一个路由可以根据请求的 HTTP 方法执行不同的逻辑，这对于处理表单提交等交互性操作非常有用。
注意事项与最佳实践
模板文件位置: Flask 默认在应用根目录下的 templates 文件夹中查找模板。请确保您的 HTML 文件放置在此目录中。
-
url_for() 函数: 在实际项目中，建议使用 Flask 的 url_for() 函数来生成 URL，而不是硬编码路径。这可以提高代码的可维护性，因为即使路由规则发生变化，您也只需修改 @app.route 装饰器，而无需修改所有模板中的链接。
<!-- 在 index.html 中使用 url_for --> <a href="{{ url_for('register') }}">注册</a>url_for('register') 会根据名为 register 的函数（即 @app.route('https://www.php.cn/link/3db893ff5d6c0e9dccfed451a741853f') 对应的函数）生成正确的 URL。
调试模式: 在开发阶段，设置 app.run(debug=True) 可以让 Flask 应用在代码修改后自动重载，并提供详细的错误信息，极大地提高了开发效率。但在生产环境中，务必关闭调试模式。
总结
通过 Flask 的 @app.route 装饰器和 render_template 函数，您可以轻松地在 Web 应用程序中实现 HTML 页面间的导航。理解如何定义路由、创建链接以及处理不同的 HTTP 方法是构建功能完善的 Flask 应用的关键。结合 url_for() 等最佳实践，您的应用将更具健壮性和可维护性。
