路由与视图

路由是 Flask 应用的核心，它将 URL 映射到 Python 函数。

基本路由

使用 @app.route() 装饰器定义路由：

from flask import Flask

app = Flask(__name__)

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

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

动态路由

基本变量

@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}'

@app.route('/path/<path:subpath>')
def show_subpath(subpath):
    return f'子路径: {subpath}'

支持的转换器：

转换器	说明
string	默认，接受不含斜杠的文本
int	正整数
float	正浮点数
path	类似 string，但包含斜杠
uuid	UUID 字符串

HTTP 方法

指定方法

from flask import request

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        return '处理登录'
    else:
        return '显示登录表单'

使用专用装饰器

@app.get('/users')
def get_users():
    return '获取用户列表'

@app.post('/users')
def create_user():
    return '创建用户'

@app.put('/users/<int:id>')
def update_user(id):
    return f'更新用户 {id}'

@app.delete('/users/<int:id>')
def delete_user(id):
    return f'删除用户 {id}'

URL 构建

使用 url_for() 生成 URL：

from flask import url_for

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

@app.route('/user/<username>')
def profile(username):
    return f'{username} 的个人资料'

# 生成 URL
with app.test_request_context():
    print(url_for('index'))                    # /
    print(url_for('profile', username='john')) # /user/john

重定向

from flask import redirect, url_for

@app.route('/old-page')
def old_page():
    return redirect(url_for('new_page'))

@app.route('/new-page')
def new_page():
    return '新页面'

自定义转换器

from werkzeug.routing import BaseConverter

class ListConverter(BaseConverter):
    def to_python(self, value):
        return value.split(',')
    
    def to_url(self, values):
        return ','.join(str(v) for v in values)

app.url_map.converters['list'] = ListConverter

@app.route('/items/<list:items>')
def show_items(items):
    return f'项目: {items}'

蓝图路由

使用 Blueprint 组织路由：

from flask import Blueprint

# 创建蓝图
auth_bp = Blueprint('auth', __name__, url_prefix='/auth')

@auth_bp.route('/login')
def login():
    return '登录页面'

@auth_bp.route('/register')
def register():
    return '注册页面'

# 注册蓝图
app.register_blueprint(auth_bp)

路由最佳实践

1. 使用有意义的 URL：/users/123 优于 /u/123
2. 使用复数名词：/users 优于 /user
3. 使用小写字母和连字符：/user-profiles 优于 /userProfiles
4. 避免动词：使用 HTTP 方法代替，如 POST /users 优于 /create-user

错误处理

from flask import render_template

@app.errorhandler(404)
def not_found(error):
    return render_template('404.html'), 404

@app.errorhandler(500)
def internal_error(error):
    return render_template('500.html'), 500

下一步

学习如何处理 HTTP 请求和响应。