Blueprint注册顺序决定路由匹配优先级，后注册的同路径路由会静默覆盖前者；url_prefix不支持动态段，需用独立蓝图或视图内解析；template_folder/static_folder是相对蓝图文件的路径；扩展实例须延迟绑定至app.extensions。
Blueprint注册顺序影响路由匹配优先级
Flask不会自动按字母或目录顺序注册蓝图，app.register_blueprint() 的调用顺序直接决定路由匹配的优先级。如果两个蓝图都注册了 /admin 路由，后注册的那个会覆盖前一个——不是报错，而是静默覆盖。
常见错误现象：本地开发时一切正常，上线后某个管理页面突然 404；或者 API 返回了错误模板内容，实际是另一个蓝图的 render_template() 拦截了请求。
- 始终在
create_app()工厂函数内显式控制注册顺序，比如先注册auth_bp，再user_bp，最后admin_bp - 避免在多个位置分散调用
register_blueprint()，尤其不要在蓝图文件内部反向导入 app 实例去注册自己 - 调试时可打印
app.url_map查看所有已注册规则：print(list(app.url_map.iter_rules()))
url_prefix嵌套不支持动态段，但可组合使用
url_prefix 参数只接受静态字符串，不能写成 url_prefix='/api/v<version>'</version>。试图这么写会直接抛出 ValueError: Invalid URL prefix。
真实场景中，API 版本控制、租户隔离（如 /t/{tenant_id}/users）等需求必须靠其他方式实现。
立即学习“Python免费学习笔记（深入）”；
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 版本控制推荐做法：为每个大版本建独立蓝图，如
v1_bp = Blueprint('v1', __name__, url_prefix='/api/v1')，再单独注册 - 租户路径需在视图函数内解析：注册
tenant_bp = Blueprint('tenant', __name__, url_prefix='/t')，然后在@tenant_bp.route('/<tenant_id>/users')中手动校验tenant_id - 不要尝试用多个
url_prefix嵌套（如先注册/t，再注册/t/<id>），Flask 不支持这种链式前缀
蓝图的 template_folder 和 static_folder 是相对路径，不是包内路径
当你写 Blueprint('blog', __name__, template_folder='templates')，Flask 实际查找的是「当前 Python 文件所在目录的子目录 templates/」，而不是项目根目录或 app/templates/。
容易踩的坑：本地运行正常，部署到生产环境后所有模板 500，错误日志里出现 TemplateNotFound —— 很可能是因为你用了包结构（如 blueprints/blog/__init__.py），但 template_folder='templates' 指向的是 blueprints/blog/templates/，而你把模板放到了 templates/blog/。
- 明确指定绝对路径更可靠：
template_folder=os.path.join(os.path.dirname(__file__), 'templates') - 若坚持用相对路径，确保目录结构与蓝图文件位置严格对应
- 静态文件同理：
static_folder='static'指向的是蓝图同级的static/目录，不是全局static/
蓝图间共享配置和扩展实例要绕过循环引用
蓝图经常需要访问 db、cache 或 mail 等扩展实例，但直接在蓝图文件里导入并初始化会导致循环引用（比如 auth.py 导入 db，而 db 又依赖 auth.py 中的模型）。
这不是 Flask 的 bug，而是 Python 模块加载机制的必然结果。
- 必须用“延迟绑定”：在
create_app()中初始化扩展，再通过app.extensions或自定义属性挂载，蓝图内通过current_app.extensions['sqlalchemy']获取 - 避免在蓝图顶层代码中调用
db.Model或cache.get()，这些操作应放在视图函数或工厂函数内部 - 模型定义建议统一放在
models/包下，由主应用初始化时导入，蓝图只负责使用
