【Flask】：轻量级Python Web框架详解

news2025/6/12 7:12:13

什么是Flask？

Flask是一个用Python编写的轻量级Web应用框架。它被称为"微框架"(microframework)，因为它核心简单但可扩展性强，不强制使用特定的项目结构或库。Flask由Armin Ronacher开发，基于Werkzeug WSGI工具包和Jinja2模板引擎构建。

Flask的核心特性

轻量级：核心功能精简，只包含基本组件
灵活性：不强制项目结构，开发者可以自由选择扩展
易扩展：通过Flask扩展可以轻松添加各种功能
内置开发服务器和调试器：方便开发和测试
集成单元测试支持：便于编写和运行测试
RESTful请求分发：支持HTTP请求处理
使用Jinja2模板引擎：强大的模板系统

安装Flask

安装Flask非常简单，只需要使用pip：

pip install flask

一个最简单的Flask应用

from flask import Flask

app = Flask(__name__)

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

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

将这段代码保存为app.py并运行，访问http://127.0.0.1:5000/就能看到"Hello, World!"的响应。

Flask核心组件详解

1. 路由系统

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

@app.route('/user/<username>')
def show_user_profile(username):
    return f'User {username}'

@app.route('/post/<int:post_id>')
def show_post(post_id):
    return f'Post {post_id}'

支持的类型转换器：

string：(默认)接受任何不包含斜杠的文本
int：接受正整数
float：接受正浮点数
path：类似string但包含斜杠
uuid：接受UUID字符串

2. 请求对象

Flask提供了request对象来访问请求数据：

from flask import request

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        return f"User {request.form['username']} logged in"
    else:
        return '''
            <form method="post">
                <input type="text" name="username">
                <input type="submit" value="Login">
            </form>
        '''

3. 响应处理

Flask允许你灵活控制响应：

from flask import make_response

@app.route('/custom-response')
def custom_response():
    response = make_response('Custom Response')
    response.headers['X-Custom-Header'] = 'Value'
    response.status_code = 201
    return response

4. 模板渲染

使用Jinja2模板引擎：

from flask import render_template

@app.route('/hello/<name>')
def hello(name):
    return render_template('hello.html', name=name)

对应的templates/hello.html:

<!doctype html>
<title>Hello</title>
{% if name %}
  <h1>Hello {{ name }}!</h1>
{% else %}
  <h1>Hello World!</h1>
{% endif %}

5. 静态文件

Flask自动配置静态文件路由，只需将文件放在static/目录下：

<img src="{{ url_for('static', filename='image.jpg') }}">

6. 会话管理

from flask import session

app.secret_key = 'your-secret-key'

@app.route('/set-session')
def set_session():
    session['username'] = 'admin'
    return 'Session set'

@app.route('/get-session')
def get_session():
    return session.get('username', 'Not set')

Flask扩展生态系统

Flask的强大之处在于其丰富的扩展生态系统：

Flask-SQLAlchemy：数据库集成
Flask-WTF：表单处理
Flask-Login：用户认证
Flask-Mail：电子邮件支持
Flask-RESTful：构建REST API
Flask-Caching：缓存支持
Flask-Migrate：数据库迁移
Flask-SocketIO：WebSocket支持

项目结构示例

一个典型的Flask项目结构：

/myflaskapp
    /app
        /templates
            base.html
            index.html
        /static
            /css
            /js
            /images
        /models
            __init__.py
            user.py
        /views
            __init__.py
            auth.py
            main.py
        __init__.py
        config.py
    /migrations
    /tests
        __init__.py
        test_basic.py
    requirements.txt
    run.py

Flask与Django的比较

特性	Flask	Django
类型	微框架	全栈框架
灵活性	高	较低
学习曲线	平缓	较陡峭
内置功能	少，但可扩展	多，包含ORM、Admin等
适用场景	小型应用、API、微服务	大型复杂应用
模板引擎	Jinja2	Django模板
ORM	无内置，常用SQLAlchemy扩展	内置强大ORM