蓝图注册顺序决定路由匹配优先级，后注册的同名路由会覆盖先注册的；需统一集中注册并按业务层级排序，显式配置url_prefix、template_folder和static_folder，跨蓝图数据共享应使用g或current_app.config而非全局变量。
蓝图注册顺序影响路由匹配优先级
Flask 中 Blueprint 不是“注册即生效”，而是依赖 app.register_blueprint() 的调用时机和顺序。后注册的蓝图中同名路由（如都定义了 /api/users）会覆盖先注册的——这不是 bug，是 Flask 的设计行为。
常见错误现象：本地开发时功能正常，上线后某个接口突然返回 404 或返回了错误模块的数据，大概率是蓝图注册顺序被重构打乱了。
- 始终在所有蓝图定义完成后，统一集中注册，避免分散在各模块文件末尾调用
register_blueprint - 按业务层级排序注册：公共工具类蓝图（如
auth_bp）优先，核心业务蓝图（如user_bp）次之，管理后台类（如admin_bp）最后 - 注册时显式传入
url_prefix，哪怕为空字符串，避免隐式根路径冲突
蓝图内静态资源与模板路径需显式声明
蓝图默认不自动继承应用级的 static_folder 和 template_folder。若直接在蓝图中用 render_template('index.html') 或 url_for('static', filename='js/app.js')，却没配好路径，就会报 TemplateNotFound 或 404。
使用场景：你把用户模块拆进 users/ 目录，希望它的 HTML 放在 users/templates/、JS 放在 users/static/，而不是全堆到项目根目录下。
- 创建蓝图时必须指定
template_folder和static_folder，例如：Blueprint('user', __name__, template_folder='templates', static_folder='static') - 模板中引用本蓝图静态文件，用
url_for('user.static', filename='css/style.css')，其中user是蓝图名，不能省略 - 若多个蓝图共用一套 CSS/JS，建议提取到应用级
static/，并在主 app 初始化时配置，而非每个蓝图重复挂载
蓝图间共享数据要用 app_context 或 g，别依赖全局变量
有人试图在蓝图文件顶部写 CURRENT_ENV = 'prod'，然后在视图里读取——这在多线程或 gunicorn 多 worker 场景下必然出错，因为全局变量不隔离。
正确做法是利用 Flask 提供的上下文机制：
- 跨蓝图传递请求级数据（如当前登录用户），用
flask.g：在before_request钩子里赋值，在任意蓝图视图中通过g.current_user访问 - 需要在蓝图初始化阶段读取配置（如数据库 URL），从
current_app.config获取，不要硬编码或读取外部模块变量 - 若需跨蓝图复用工具函数（如格式化时间），放在独立的
utils.py中，由各蓝图 import，而非塞进某个蓝图的__init__.py
url_for 在蓝图内外调用方式不同
这是最常踩的坑：在模板里写 {{ url_for('index') }} 能跳首页，但换成蓝图里的视图就 404；或者在蓝图 A 的视图里调用 url_for('other_bp.detail') 报错说 endpoint 不存在——根本原因是 endpoint 名称规则没搞清。
Flask 默认把蓝图内的视图 endpoint 注册为 蓝图名.函数名，不是单纯函数名。
- 在蓝图内部跳转，推荐写
url_for('.list_users')（点号开头表示当前蓝图） - 在主 app 或其他蓝图里跳转到
user_bp的视图，必须写url_for('user.list_users')，其中user是注册蓝图时传的 name 参数 - 如果注册蓝图时用了
name='v1_user'，那 endpoint 就是v1_user.list_users，别想当然用user - 调试 endpoint 是否存在？启动后访问
/debug-toolbar（装了 flask-debugtoolbar）或打印app.url_map
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
