website

Flask Docs

所属分类:开发者在线工具箱

Flask Docs:Flask 官方指南、教程与扩展开发文档,版本 3.1.x

Flask Docs 是轻量级 Python Web 框架 Flask 的官方文档站。Flask 基于 WSGI,首页说明它依托 Werkzeug、Jinja 与 Click 三个工具库工作。文档标题显示版本为 3.1.x,适合想用 Python 快速搭建网站或接口、并希望逐步扩展到较大应用的开发者。

Flask Docs:查阅 Flask 3.1 的快速入门、教程、模板与扩展开发说明

发布于 2026年10月18日更新于 2026年10月29日

首页与阅读顺序

文档首页先给出 Installation 与 Quickstart 两个起点,然后是较完整的 Tutorial 教程,用于从零做出一个小型博客应用。首页还提示,常见写法集中在 Patterns for Flask 一节,框架各组件的细节在其余章节,完整函数与类的说明在 API 一节。

Flask 文档首页截图,左侧为 Project Links 和 Contents 目录,正文上方是 Flask 标志,下方为 User’s Guide 下的 Installation 与 Quickstart 列表,右下角可切换语言与 stable 版本

User’s Guide 的 Quickstart 按主题排列,依次为 A Minimal Application、Debug Mode、HTML Escaping、Routing、Static Files、Rendering Templates、Accessing Request Data、Redirects and Errors、About Responses、Sessions、Message Flashing、Logging、Using Flask Extensions 和 Deploying to a Web Server。Templates 一节说明 Jinja 的设置、标准上下文、自动转义、过滤器与上下文处理器;Testing 一节介绍测试客户端、会话访问和 CLI 命令测试。

扩展开发指南

Extension Development 页面面向想编写 Flask 扩展的人。页面建议扩展名中包含 flask,并给出命名示例,如 Flask-Name 对应导入名 flask_name。在初始化部分,页面推荐写一个带 init_app 方法的类:扩展实例可以先独立创建,之后在应用工厂函数中再调用 init_app。页面说明这种写法便于支持应用工厂模式、避免循环导入,并让测试时使用不同配置更容易。

Flask 扩展开发文档截图,正文标题为 The Extension Class and Initialization,展示 HelloExtension 类、init_app 方法和 create_app 工厂函数的 Python 代码示例

页面还说明,扩展不应把应用保存在 self.app 上,应用级状态应放在 Flask.extensions 字典中,并使用一个只属于该扩展的键名。