Python Flask：轻量级Web框架入门指南 – wiki词典

作者： /

Python Flask：轻量级Web框架入门指南

在Web开发领域，Python拥有众多强大的框架。其中，Django以其“包罗万象”的特性而闻名，而Flask则以其“微框架”和“不言自明”的哲学脱颖而出。对于那些寻求快速启动、高度自由和极简主义的开发者来说，Flask无疑是一个极佳的选择。

什么是Flask？

Flask是一个基于Python的轻量级Web服务器网关接口（WSGI）Web应用框架。它被称为“微框架”，但这并不意味着它功能不全。相反，它意味着Flask核心精简，不强制依赖特定的工具或库。它提供了构建Web应用所需的基本功能，如路由、请求处理、模板渲染等，但将数据库抽象层、表单验证等更高级的功能留给开发者自行选择和集成。

为什么选择Flask？

  1. 轻量级与灵活性：Flask的核心代码库非常小巧，只包含最基本的功能。这意味着它没有太多预设的决策，开发者可以根据项目需求自由选择组件和库。这种灵活性在构建API服务或小型应用时尤其有利。
  2. 简单易学：Flask的API设计直观且易于理解。对于Python开发者而言，学习曲线相对平缓，可以快速上手并构建功能。
  3. 强大的生态系统与扩展：尽管Flask自身精简，但它拥有一个活跃的社区和丰富的扩展生态。例如，Flask-SQLAlchemy用于数据库集成，Flask-WTF用于表单处理，Flask-Login用于用户会话管理等，这些扩展能够轻松地为Flask应用添加复杂功能。
  4. 出色的文档：Flask的官方文档被广泛认为是Web框架文档中的典范，内容详尽、清晰，非常适合学习和查阅。
  5. 适用于小型项目和API：对于微服务、RESTful API或小型Web应用，Flask的简洁性使其成为理想选择，能够避免大型框架带来的额外开销。

安装Flask

安装Flask非常简单，建议在虚拟环境中进行，以避免项目间的依赖冲突。

  1. 创建虚拟环境：
    bash
    python -m venv venv
  2. 激活虚拟环境：
    • Windows: venv\Scripts\activate
    • macOS/Linux: source venv/bin/activate
  3. 安装Flask：
    bash
    pip install Flask

你的第一个Flask应用（Hello World）

让我们创建一个最简单的Flask应用，显示“Hello, World!”。

创建一个名为app.py的文件，并写入以下代码：

“`python
from flask import Flask

创建一个Flask应用实例

app = Flask(name)

定义一个路由，当访问根URL时，执行下面的函数

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

当直接运行此脚本时，启动Web服务器

if name == ‘main‘:
# debug=True 会在代码更改时自动重载服务器，并提供一个交互式调试器
app.run(debug=True)
“`

运行应用：
在激活虚拟环境的终端中，运行：
bash
python app.py
你将看到类似以下的输出：
* Serving Flask app 'app'
* Debug mode: on
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
* Running on http://127.0.0.1:5000
Press CTRL+C to quit
* Restarting with stat
* Debugger is active!
* Debugger PIN: XXX-XXX-XXX
在浏览器中打开http://127.0.0.1:5000，你将看到“Hello, World!”。

路由（Routing）

路由是Web应用的核心，它将URL路径映射到特定的Python函数。Flask使用@app.route()装饰器来定义路由。

动态路由

你可以在URL中捕获变量，并将其作为参数传递给函数。

“`python
from flask import Flask
app = Flask(name)

@app.route(‘/’)
def index():
return ‘这是首页’

@app.route(‘/user/‘)
def show_user_profile(username):
# username 变量会从URL中获取
return f’用户: {username}’

@app.route(‘/post/‘)
def show_post(post_id):
# post_id 变量会被转换为整数
return f’文章ID: {post_id}’

if name == ‘main‘:
app.run(debug=True)
``
访问http://127.0.0.1:5000/user/Alice将显示“用户: Alice”，访问http://127.0.0.1:5000/post/123` 将显示“文章ID: 123”。

模板（Templates）

在实际的Web应用中，我们很少直接在Python代码中返回HTML字符串。Flask使用Jinja2模板引擎来渲染HTML文件，实现前后端分离。

  1. 创建templates文件夹：
    在app.py文件同级目录下，创建一个名为templates的文件夹。Flask会自动在这个文件夹中查找模板文件。

  2. 创建HTML模板文件：
    在templates文件夹中，创建一个index.html文件：
    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 }}</title>
    </head>
    <body>
    <h1>{{ message }}</h1>
    <p>这是一个Flask应用。</p>
    <ul>
    {% for item in items %}
    <li>{{ item }}</li>
    {% endfor %}
    </ul>
    </body>
    </html>

  3. 在Flask应用中渲染模板：
    修改app.py，导入render_template函数：
    “`python
    from flask import Flask, render_template

    app = Flask(name)

    @app.route(‘/’)
    def index():
    # 传递变量到模板
    return render_template(‘index.html’,
    title=’Flask入门’,
    message=’欢迎来到我的Flask页面！’,
    items=[‘Python’, ‘Flask’, ‘Jinja2’])

    if name == ‘main‘:
    app.run(debug=True)
    ``
    现在，访问    http://127.0.0.1:5000，你将看到一个由index.html渲染的页面，并且Python代码中传递的变量（title,message,items）都已正确显示。Jinja2模板使用双大括号{{ variable }}来显示变量，{% for … %}`来控制流程。

Flask扩展（Extensions）

Flask的强大之处在于其丰富的扩展。这些扩展为Flask提供了与更大型框架类似的功能，而又保持了核心的轻量级。一些常用的扩展包括：
* Flask-SQLAlchemy：与SQLAlchemy集成，提供ORM（对象关系映射）功能，方便数据库操作。
* Flask-Migrate：基于Alembic实现数据库迁移。
* Flask-WTF：方便处理Web表单和CSRF保护。
* Flask-Login：管理用户会话，处理用户登录和登出。
* Flask-RESTful / Flask-RESTX：用于快速构建RESTful API。

通过这些扩展，开发者可以根据项目需求，逐步构建功能完善的Web应用。

总结

Flask是一个优雅、灵活且功能强大的Python Web微框架。它鼓励开发者做出自己的选择，而不是强制采用特定模式，这使得它在构建轻量级应用、API和微服务时尤其受欢迎。通过本入门指南，你应该已经对Flask有了基本的认识，并能够构建第一个简单的Web应用。要深入学习，建议查阅官方文档，并尝试使用各种Flask扩展来扩展你的应用功能。

滚动至顶部