Flask 路由（完整教程）

Flask 路由：构建 Web 应用的“导航地图”

如果你把一个 Web 应用比作一座城市，那么 Flask 路由就是这座城市的交通网络。用户从浏览器输入网址，就像开车或步行进入城市，而路由决定了他们能到达哪个目的地。没有清晰的路由系统，用户会迷失在代码的迷宫中。Flask 路由是整个应用的“入口管理器”，它将不同的 URL 请求映射到对应的处理函数，是构建可维护 Web 应用的第一步。

在 Flask 中，路由的核心机制是通过装饰器（@app.route）来实现的。它让开发者可以像写自然语言一样，声明“当用户访问这个路径时，执行这个函数”。这种设计简洁而强大，非常适合初学者快速上手，也足够灵活应对复杂项目。

基础路由定义：从“Hello World”开始

我们先从最简单的例子开始，创建一个最小可运行的 Flask 应用，展示基础路由的写法。

from flask import Flask

app = Flask(__name__)

@app.route('/')
def index():
    return '欢迎来到首页！'

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

这段代码中，@app.route('/') 就是核心。它告诉 Flask：当用户访问网站的根路径（如 http://127.0.0.1:5000/）时，应该调用 index() 函数。这个函数返回一个字符串，作为响应内容。

💡 提示：debug=True 是开发模式开关，它会在代码出错时显示详细错误信息，并支持自动重载，提升开发效率。

你可以将这个文件保存为 app.py，然后在终端运行：

python app.py

打开浏览器访问 http://127.0.0.1:5000/，就能看到“欢迎来到首页！”的提示。这就是 Flask 路由的起点。

多个路由与路径匹配策略

一个网站不可能只有一个页面。Flask 支持定义多个路由，每个对应不同的 URL 路径。

from flask import Flask

app = Flask(__name__)

@app.route('/')
def index():
    return '<h1>首页</h1>'

@app.route('/about')
def about():
    return '<h1>关于本项目</h1>'

@app.route('/contact')
def contact():
    return '<h1>联系我们</h1>'

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

现在你可以访问：

• http://127.0.0.1:5000/ → 首页
• http://127.0.0.1:5000/about → 关于页面
• http://127.0.0.1:5000/contact → 联系页面

注意：路径匹配是精确的。/about 不会匹配 /about-us，除非你显式定义。这就像城市里的街道名称必须完全一致才能到达目的地。

路由参数：动态路径的实现

现实中的 URL 往往包含动态信息，比如用户 ID、文章标题等。Flask 通过“路径变量”来处理这类需求。

@app.route('/user/<username>')
def show_user(username):
    return f'你好，用户 {username}！'

@app.route('/post/<int:post_id>')
def show_post(post_id):
    return f'文章 ID 为 {post_id} 的内容正在加载...'

这里的 <username> 和 <int:post_id> 就是路径变量。Flask 会自动提取 URL 中的这部分内容，并作为参数传入函数。

• <username>：提取任意字符串（非斜杠），作为 username 参数
• <int:post_id>：提取整数，自动转换为 Python 的 int 类型

⚠️ 注意：<int:...> 是类型转换器，它能自动将字符串转为整数。如果用户访问 /post/abc，Flask 会返回 404 错误，因为 abc 无法转为整数。

这种机制让你无需手动解析 URL，极大简化了开发流程。

路由规则与路径匹配的细节

Flask 的路由系统支持更复杂的路径模式，理解它们有助于写出更健壮的应用。

📌 重点：<path:...> 是一个特殊类型转换器，它可以匹配包含斜杠的路径，比如 /api/v1/data。如果不使用 path，斜杠会被当作路径分隔符，导致匹配失败。

举个例子：

@app.route('/api/<path:version>')
def api_handler(version):
    return f'API 版本：{version}'

访问 /api/v1/users 时，version 的值是 v1/users，而不是只取 v1。

路由装饰器的高级用法

Flask 允许一个函数绑定多个路径，这在实际开发中非常实用，比如让 /home 和 / 显示相同内容。

@app.route('/')
@app.route('/home')
def home():
    return '<h1>首页或主页</h1>'

两个 @app.route 装饰器同时作用于同一个函数，表示“访问 / 或 /home 都执行这个函数”。这相当于在城市地图中，设置两个入口通往同一个景点。

此外，还可以指定 HTTP 方法，让路由只响应特定请求类型：

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'GET':
        return '<form method="POST"><input name="username"><button>登录</button></form>'
    elif request.method == 'POST':
        username = request.form['username']
        return f'欢迎登录：{username}'

✅ 说明：methods=['GET', 'POST'] 表示该路由支持 GET 和 POST 请求。GET 用于获取页面，POST 用于提交数据。这是构建表单功能的基础。

路由命名与 URL 生成

在大型项目中，硬编码 URL 会导致维护困难。Flask 提供了 url_for() 函数，可以根据路由函数名生成对应的 URL。

@app.route('/')
def index():
    # 生成 /about 的 URL
    about_url = url_for('about')
    return f'<a href="{about_url}">前往关于页面</a>'

@app.route('/about')
def about():
    return '这是关于页面'

这样，即使你以后改了 /about 的路径为 /about-us，url_for('about') 会自动更新，无需修改所有链接。

✅ 建议：在模板中（如 Jinja2）使用 {{ url_for('about') }} 生成链接，是最佳实践。

总结：Flask 路由是 Web 开发的基石

Flask 路由不仅是简单的“路径到函数”的映射，更是一种设计思维的体现。它让开发者可以专注于业务逻辑，而不用关心底层的请求解析。从最简单的 / 到复杂的动态路径、类型转换、多方法支持，Flask 路由提供了足够的灵活性来应对各种场景。

掌握 Flask 路由，就等于掌握了 Web 应用的“导航地图”。它让你的代码清晰、可维护，并为后续的模板渲染、数据库交互、用户认证等打下坚实基础。无论是初学者构建个人博客，还是中级开发者开发企业级系统，Flask 路由都是不可或缺的核心技能。

记住：一个设计良好的路由结构，能让整个应用像城市交通一样高效运转——用户能快速到达目的地，开发者也能轻松维护与扩展。