blueprint注册顺序决定路由匹配优先级，后注册的同路径规则会覆盖先注册的；需显式集中注册、用url_prefix隔离、声明static_folder/template_folder、通过g或current_app共享数据、避免嵌套blueprint。
Blueprint注册顺序影响路由匹配优先级
Flask不会自动按目录结构或文件名排序加载Blueprint，app.register_blueprint() 的调用顺序直接决定同路径下多个Blueprint的路由匹配优先级。后注册的会覆盖先注册的同路径规则（除非用了url_prefix隔离）。
常见错误现象：404 或意外命中了错误的视图函数，尤其在开发阶段反复增删模块后容易出现。
- 始终在
app.py或主入口中显式、集中地注册所有Blueprint，避免分散在各模块内部调用register_blueprint - 若两个
Blueprint都定义了/api/users，先注册的生效；想让后者生效，就把它放在注册列表靠后位置 - 用
url_prefix='/admin'强制隔离管理后台路由，比依赖注册顺序更可靠
Blueprint内静态文件和模板路径需显式声明
默认情况下，Blueprint不会自动查找同名子目录下的static/或templates/，必须通过构造参数明确指定，否则url_for('bp_name.static', filename='...') 会抛出BuildError。
使用场景：你把用户模块拆进users/包，里面放了users/static/css/user.css，但页面里写url_for('users.static', filename='css/user.css') 报错。
- 创建
Blueprint时加上static_folder='static'和template_folder='templates'，路径是相对于该Blueprint所在Python文件的位置 - 如果
users/__init__.py是Blueprint定义处，那static_folder='static'指的就是users/static/ - 不建议省略
template_folder——即使只用render_template全局模板，也建议设为'templates'，避免未来扩展时混淆
跨Blueprint共享数据要用app context或g对象
Blueprint之间不能直接导入对方的变量或函数来共享状态（比如当前登录用户），因为模块导入发生在应用启动前，而请求上下文是运行时动态的。硬导会导致循环导入或RuntimeError: Working outside of application context。
性能影响：滥用g存大量数据可能增加每个请求的内存开销，但用于临时挂载current_user、数据库连接等轻量对象完全没问题。
- 在
before_request钩子里统一从session或token解析用户，并存入g.current_user - 需要跨模块访问配置项？从
current_app.config读，不要在Blueprint里硬编码DEBUG=True - 避免在
Blueprint顶层代码中调用current_app——此时app可能还没初始化，改用@bp.before_app_first_request（已弃用）或更稳妥的工厂函数模式
嵌套Blueprint需用add_url_rule或子类化处理
Flask原生不支持“Blueprint嵌套Blueprint”，即不能直接把一个Blueprint注册到另一个Blueprint上。试图这么做会报AttributeError: 'Blueprint' object has no attribute 'url_map'。
常见替代方案只有两种：手动挂载子路由，或用第三方扩展如flask-blueprint-nest（不推荐引入额外依赖）。
- 最简做法：在父
Blueprint中用add_url_rule绑定子模块的视图函数，路径拼接靠人工维护（例如bp.add_url_rule('/v1/users', view_func=user_list)） - 若子模块逻辑重、路由多，建议提升为独立
Blueprint，并在主app中用url_prefix='/v1'统一前缀，而非强行嵌套 - 切勿在
Blueprint内部执行child_bp.register_blueprint(...)——语法合法但运行时报错，这个坑很多人踩过
Blueprint的name参数：它不仅是标识符，还作为url_for的命名空间前缀。一旦改名，所有相关url_for('old_name.view') 都得同步更新，且IDE通常无法跨文件重构这种字符串引用。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
