Blueprint必须显式注册到Flask应用实例，否则路由404；需调用app.register_blueprint()并指定url_prefix；蓝图的template_folder和static_folder需显式声明；跨蓝图访问扩展需应用上下文；不支持嵌套注册，name参数须全局唯一。
Blueprint 必须显式注册到 Flask 应用实例上
很多人写完 Blueprint 却发现路由 404，根本原因是没调用 app.register_blueprint()。Flask 不会自动扫描或加载蓝图，必须手动挂载。哪怕蓝图定义在 __init__.py 同级目录，不注册就等于不存在。
常见错误场景：把蓝图对象定义好了，也写了 @bp.route()，但启动服务后访问对应路径直接报 404 —— 先检查 app.py 或工厂函数里有没有这行：
app.register_blueprint(user_bp, url_prefix='/api/users')
-
url_prefix是可选的，但强烈建议加上，避免路由冲突；不加则所有路由以根路径为前缀 - 同一个蓝图不能重复注册，否则会报
AssertionError: The name 'xxx' is already registered for a different blueprint - 如果用工厂函数模式（
create_app()），注册操作必须放在工厂函数内部、return app之前
蓝图内静态文件和模板路径要显式声明
Blueprint 默认不会继承主应用的 static_folder 和 template_folder。如果你在蓝图里用 render_template('user/list.html')，却把 HTML 放在 blueprints/user/templates/user/list.html，那它找不到——除非你告诉它去哪找。
正确做法是在创建蓝图时指定路径：
user_bp = Blueprint('user', __name__,<br> template_folder='templates',<br> static_folder='static')
- 路径是相对于蓝图所在 Python 文件的相对路径，不是相对于项目根目录
- 若多个蓝图共用一套模板，可以统一放在项目
templates/下，但需确保render_template()中的路径匹配实际结构（如'user/detail.html'对应templates/user/detail.html） - 静态文件同理：
url_for('user.static', filename='js/app.js')才能正确生成 URL，其中user是蓝图名
蓝图间共享配置或扩展实例要用 app_context 或延迟绑定
在蓝图文件里直接写 db.session.add(...) 会报错：RuntimeError: No application found. Either work inside a view function or push an application context。因为蓝图本身没有上下文，db 等扩展依赖 Flask 的应用上下文。
两种稳妥做法：
- 在视图函数中使用，此时请求已进入上下文，
db可直接用 - 需要在蓝图外初始化逻辑（比如信号、命令注册），用
@user_bp.before_app_first_request（已弃用）或更推荐的：在工厂函数中完成扩展初始化，蓝图只负责定义路由和业务逻辑 - 若必须在蓝图模块里访问配置，用
current_app.config['SECRET_KEY']，但要确保调用发生在请求或应用上下文中
嵌套蓝图或动态注册需绕过 Flask 原生命令限制
Flask 官方不支持“蓝图套蓝图”。比如你写了个 admin_bp，又想在里面再挂一个 product_bp，直接 admin_bp.register_blueprint(product_bp) 会失败 —— Blueprint 对象没有 register_blueprint 方法。
可行方案只有两个：
- 所有子模块都平级注册到
app，靠url_prefix模拟嵌套语义，例如/admin/products、/admin/users - 用第三方扩展如
flask-blueprint-nest（小众，维护风险高），或自己封装注册逻辑：遍历子蓝图的deferred_functions并注入父前缀，但极易出错，不推荐在生产环境尝试
真正容易被忽略的是：蓝图的 name 参数必须全局唯一，哪怕不同文件里的蓝图，重名就会覆盖或报错；而 url_prefix 可以相同，只要路由规则不冲突就行。
