蓝图注册顺序决定路由匹配优先级，先注册者优先响应请求；错误顺序会导致/login等路由被兜底路径如/拦截而返回404。
蓝图注册顺序决定路由是否能被访问，不是“能不能用”，而是“谁先抢到请求”——写错顺序，/login可能被/<path></path>直接吞掉。
注册顺序直接影响路由匹配结果
Flask 按 app.register_blueprint() 的调用顺序构建 url_map，同路径下先注册的蓝图优先匹配，后注册的即使定义了相同路由也不会生效。
- 错误示例：把兜底蓝图（如
api_bp中写了@bp.route('/<rest>')</rest>）放在最前注册，会导致/login、/admin全部 404 - 推荐顺序：
core_bp（首页、静态页）→auth_bp（登录/登出）→user_bp→admin_bp - 调试时加一行
print(app.url_map)，确认实际注册顺序和路径是否符合预期
蓝图初始化时 __name__ 必须与模块路径一致
这个参数不光是名字，它决定了 Flask 查找 templates/ 和 static/ 的相对路径，也影响 url_for() 构建是否正确。
- 如果蓝图文件在
blueprints/user.py，必须写Blueprint('user', __name__)，此时__name__是'blueprints.user' - 写成
Blueprint('user', 'user')或Blueprint('user', '__main__')，会导致模板找不到、url_for('user.static', filename='...')报错 - 包结构含
__init__.py（如blueprints/auth/__init__.py），则__name__是'blueprints.auth'，不能简写为'auth'
模板和静态文件必须显式隔离，否则会互相覆盖
Flask 默认把所有蓝图的 templates/ 合并进全局搜索路径，同名模板（比如 base.html）谁后加载谁生效，且无警告。
Flask Wrap
下载
火焰围攻 授权: q15040409-creator.功能概述火焰围攻 授权: q15040409-creator.是一项面向实际任务的技能，主要用于Description.；Flask Web. - Python.；核心要点HTTP?；.Version.1.0.tags. wrap.github.automation.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用与执行使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要
立即学习“Python免费学习笔记（深入）”；
- 每个蓝图初始化时要指定独立路径：
Blueprint('user', __name__, template_folder='templates/user', static_folder='static/user') - 模板中引用必须带命名空间：
render_template('user/profile.html')，不能只写'profile.html' - 静态文件 URL 要用命名空间：
url_for('user.static', filename='js/main.js') - 应用级
base.html建议放在主templates/下，所有蓝图模板都继承它，避免多层嵌套混乱
蓝图间不能靠模块变量共享状态
数据库连接、配置对象、缓存实例等，如果直接 import 到蓝图模块顶部，在蓝图导入时就初始化了，无法感知应用上下文变化，容易导致连接复用失败或配置错乱。
- 改用
g（请求上下文）或current_app（应用上下文）获取资源 - 数据库操作必须在请求处理函数内执行，或通过工厂函数延迟初始化（如
create_app()中绑定db.init_app(app)） - 不要在蓝图里写
db = SQLAlchemy()，而应在应用工厂中统一创建并传入
最容易被忽略的是 __name__ 参数和模板路径的耦合关系——它不是命名习惯问题，而是路径解析的硬依赖；一旦写错，错误往往延迟到运行时才暴露，且报错信息不指向根源。
