蓝图注册顺序决定路由匹配优先级，先注册的蓝图优先匹配同路径请求；后注册者不覆盖前者，仅当路径无重叠时才生效。
蓝图注册顺序影响路由匹配优先级
Flask 的 app.register_blueprint() 调用顺序直接决定同路径下多个蓝图的路由匹配优先级——先注册的蓝图，其路由更早被检查。如果你有两个蓝图都定义了 @bp.route('/user')，后注册的那个不会覆盖前一个，而是根本不会被匹配到（除非路径有细微差异，比如带 trailing slash）。
常见错误是把通用蓝图（如 auth_bp）放在最后注册，结果登录页 /login 被前面某个通配或泛路径蓝图（比如 api_bp 里写了 @bp.route('/<path>')</path>）提前拦截了。
- 按业务边界分组注册：先
core_bp（首页、静态页），再auth_bp，最后admin_bp - 避免在蓝图内用
@bp.route('/')或@bp.route('/<path>')</path>这类宽泛路由，除非你明确要兜底 - 调试时可打印
app.url_map查看实际注册顺序和路径映射：print(app.url_map)
蓝图内模板路径默认不隔离，需手动指定 template_folder
Flask 默认把所有蓝图的 templates/ 目录合并进全局模板搜索路径，导致不同蓝图下的同名模板（比如 base.html）会相互覆盖——后加载的蓝图模板生效，且无警告。
这不是 bug，是设计如此；但对中大型项目来说极易引发意料外的渲染错乱。
立即学习“Python免费学习笔记（深入）”；
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 每个蓝图初始化时显式声明独立模板目录：
bp = Blueprint('user', __name__, template_folder='templates/user') - 模板中引用时用命名空间语法：
render_template('user/profile.html')，而非'profile.html' - 静态文件同理：用
static_folder='static/user'，并在模板中通过url_for('user.static', filename='css/main.css')引用
蓝图间共享数据不能靠模块级变量，要用 app_context 或 g
新手常把数据库连接、配置对象、缓存实例等直接 import 到各个蓝图模块顶部，试图复用。问题在于：这些变量在蓝图导入时就初始化了，但此时 app 可能还没创建，或不同应用实例间状态混杂。
典型症状是测试环境跑通，生产多进程部署后出现连接泄漏或配置错乱。
- 数据库对象（如 SQLAlchemy
db）应定义在独立模块（如extensions.py），用db.init_app(app)延迟到 app 创建后绑定 - 请求级数据放
flask.g：在@bp.before_request中设置，确保每个请求隔离 - 跨蓝图调用函数？封装成工具函数并接受
current_app或g为参数，别依赖全局模块变量
子域名与 URL 前缀别混用，url_prefix 优先于 subdomain
当同时设置 subdomain='api' 和 url_prefix='/v1'，Flask 会优先按 url_prefix 匹配路径，再校验子域名。这意味着 http://api.example.com/v2/users 无法命中 url_prefix='/v1' 的蓝图，哪怕子域名对得上。
更隐蔽的问题是：开发时本地没配 DNS，subdomain 实际失效，但 url_prefix 仍工作，导致环境行为不一致。
- 纯 API 服务优先用
url_prefix（如Blueprint('api', url_prefix='/api/v1')），简单可靠 - 确需子域名（如多租户前台），禁用
url_prefix，并在app.config['SERVER_NAME']显式设为example.com，否则子域名路由不生效 - 本地调试子域名时，改 hosts 文件 + 启动时加
--host=0.0.0.0，别只靠localhost
