蓝图注册顺序决定路由生效与否，后注册的会静默覆盖同路径前一个路由；必须在create_app()中集中按依赖顺序注册，禁用蓝图内反向注册；url_prefix仅支持静态字符串，API版本与租户路由需分蓝图实现；template_folder和static_folder为蓝图文件相对路径；扩展须延迟绑定至app.extensions且init_app在蓝图注册后调用；g对象跨蓝图不继承，current_app不可在模块级访问。
蓝图注册顺序直接影响路由是否生效
后注册的蓝图会静默覆盖同路径的前一个路由，不是报错，而是直接丢弃——这是上线后突然 404 或返回错误模板的最常见原因。
- 始终在
create_app()工厂函数内集中调用app.register_blueprint()，按业务依赖顺序排列：比如auth_bp→user_bp→admin_bp - 绝对不要在蓝图文件内部反向导入
app实例并自行注册，这会破坏应用工厂模式，导致测试失败和扩展初始化异常 - 调试时执行
print(list(app.url_map.iter_rules()))，一眼看出哪些规则被覆盖或重复
url_prefix 不支持动态段，但可以组合实现版本/租户路由
url_prefix='/api/v<version>'</version> 这种写法会直接抛出 ValueError: Invalid URL prefix，因为 url_prefix 只接受纯静态字符串。
- API 版本控制：为每个大版本建独立蓝图，如
v1_bp = Blueprint('v1', __name__, url_prefix='/api/v1')，再单独注册 - 租户路径（如
/t/{tenant_id}/users）：注册tenant_bp = Blueprint('tenant', __name__, url_prefix='/t')，然后在视图中用@tenant_bp.route('/<tenant_id>/users')</tenant_id>解析并校验tenant_id - 避免嵌套注册多个
url_prefix（例如先注册/t，再注册/t/<id></id>），Flask 不支持这种链式前缀
template_folder 和 static_folder 是相对蓝图文件的路径
写 Blueprint('blog', __name__, template_folder='templates')，Flask 查找的是「该蓝图 Python 文件所在目录下的 templates/ 子目录」，不是项目根目录或 app/templates/。
- 如果蓝图文件在
app/blueprints/blog.py，那template_folder='templates'就指向app/blueprints/templates/ - 想复用全局模板？直接省略
template_folder参数，Flask 会回退到应用级app.template_folder（默认是app/templates） - 静态文件同理：不设
static_folder时，会走应用级app.static_folder；设了就只认相对路径下的目录
扩展实例必须延迟绑定到 app.extensions
像 SQLAlchemy、Mail 这类扩展，不能在蓝图里直接调用 init_app(app)，否则会引发循环导入或未初始化错误。
立即学习“Python免费学习笔记（深入）”；
- 在
app/extensions.py中只实例化扩展对象，如db = SQLAlchemy()，不调init_app - 在
create_app()中完成db.init_app(app)，并确保它发生在所有蓝图注册之后 - 扩展绑定后，才能在蓝图视图中安全使用
db.session或mail.send()等功能
g 对象只在当前请求生命周期内有效，跨蓝图不自动继承；而 current_app 在蓝图内可用，但若提前访问（如模块级代码中）会触发 RuntimeError。这些细节不会报错，但会让逻辑在特定路径下悄无声息地失效。 
