在使用Flask开发应用时，随着功能增多，代码文件会变得越来越长，路由管理也会变得混乱。这时，Flask的蓝图（Blueprint） 功能就能派上用场了。蓝图就像一个“功能模板”，可以帮助我们把不同模块的路由和视图函数分组管理，让项目结构更清晰、代码更易维护。
为什么需要蓝图？¶
想象一下，如果我们在一个app.py文件里写了所有路由：用户注册、商品列表、订单管理……随着功能越来越多，代码会像面条一样纠缠不清。这时候，蓝图的作用就显现了：
- 模块化分组：把不同功能的路由（比如用户相关、商品相关）拆分成独立的“蓝图”，每个蓝图负责一部分功能。
- 代码结构清晰：不同模块的代码隔离，团队协作时更容易分工。
- 避免循环导入：大型项目中，模块间的依赖容易导致循环导入错误，蓝图可以减少这种问题。
- 复用性：蓝图可以被多个项目复用，或者在同一个项目中多次注册。
蓝图实战：从0开始创建模块化应用¶
步骤1：项目结构设计¶
我们先规划一个简单的项目结构，包含一个主应用和两个蓝图模块（用户模块和商品模块）：
myapp/
├── app.py # 主应用入口
├── user/ # 用户模块蓝图
│ ├── __init__.py # 初始化文件
│ └── routes.py # 用户相关路由
└── product/ # 商品模块蓝图
├── __init__.py
└── routes.py # 商品相关路由
app.py：主应用，负责注册所有蓝图并启动服务。user/routes.py：用户模块的路由定义。product/routes.py：商品模块的路由定义。
步骤2：创建用户模块蓝图（user）¶
在user/routes.py中，我们创建一个蓝图实例，并定义用户相关的路由：
# user/routes.py
from flask import Blueprint, render_template
# 创建蓝图实例：第一个参数是蓝图名称（唯一标识），第二个参数是__name__（当前模块名）
user_bp = Blueprint('user', __name__)
# 定义用户相关路由（注意：用蓝图的route装饰器，而非app.route）
@user_bp.route('/profile')
def profile():
return "用户个人资料页面"
@user_bp.route('/login')
def login():
return "用户登录页面"
步骤3：创建商品模块蓝图（product）¶
同理，在product/routes.py中定义商品相关路由：
# product/routes.py
from flask import Blueprint
# 创建商品模块蓝图
product_bp = Blueprint('product', __name__)
# 商品相关路由
@product_bp.route('/list')
def product_list():
return "商品列表页面"
@product_bp.route('/detail/<int:pid>')
def product_detail(pid):
return f"商品详情页：ID={pid}"
步骤4：主应用注册蓝图（app.py）¶
在主应用app.py中，导入蓝图并注册：
# app.py
from flask import Flask
from user.routes import user_bp # 导入用户蓝图
from product.routes import product_bp # 导入商品蓝图
app = Flask(__name__)
# 注册蓝图：url_prefix参数可给蓝图路由加前缀（如/user/profile）
app.register_blueprint(user_bp, url_prefix='/user')
app.register_blueprint(product_bp, url_prefix='/product')
if __name__ == '__main__':
app.run(debug=True)
步骤5：测试路由¶
运行app.py后，访问以下URL验证效果：
- 用户模块：http://localhost:5000/user/profile（个人资料）、http://localhost:5000/user/login（登录）
- 商品模块：http://localhost:5000/product/list（商品列表）、http://localhost:5000/product/detail/123（商品详情，ID=123）
蓝图的进阶用法¶
除了路由分组，蓝图还支持：
1. 模板路径隔离¶
如果模块内有自己的模板文件，可以在创建蓝图时指定template_folder：
# user/__init__.py （或在routes.py中）
user_bp = Blueprint('user', __name__, template_folder='templates')
此时，用户模块的模板应放在user/templates/user/profile.html，主应用的模板放在templates/下，Flask会优先查找蓝图的模板。
2. 静态文件隔离¶
类似模板，蓝图也可以指定static_folder来管理模块内的静态资源：
product_bp = Blueprint('product', __name__, static_folder='static')
商品模块的静态文件放在product/static/下，访问路径为/product/static/xxx.js。
3. 蓝图前缀与子域名¶
- 前缀：如步骤4中的
url_prefix='/user'，可统一给模块路由加前缀，避免路径冲突。 - 子域名：通过
subdomain参数，蓝图可仅响应特定子域名（如subdomain='admin'）。
总结¶
蓝图是Flask模块化开发的核心工具，通过它我们可以：
- 将复杂应用拆分为独立模块，降低维护成本。
- 让路由管理更清晰，代码结构更符合逻辑。
- 为大型项目的团队协作和复用提供便利。
建议初学者从第一个小项目就开始使用蓝图，养成“模块化”的开发习惯。随着项目复杂度提升，蓝图会成为你管理代码的得力助手！