通过在模板中比对 `request.endpoint` 与路由端点名，可自动为 bootstrap 5 导航栏添加 `active` 类，实现点击后持续高亮当前页面，无需手动传递变量。

在 Flask 应用中集成 Bootstrap 5 导航栏时，常见的误区是试图通过模板变量（如 active_page）手动控制 active 类——这不仅增加维护成本，还容易因命名不一致（如 'edit_profile' vs 'edit_profile.html'）导致失效。正确做法是利用 Flask 内置的 request.endpoint 属性，它能精确反映当前请求所匹配的视图函数端点（如 'auth.edit_profile'），天然具备动态性与可靠性。

以下是推荐的实现方式（适配 Bootstrap 5 语义化结构）：

<nav class="navbar navbar-expand-md navbar-dark bg-dark">
  <div class="container-fluid">
    <a class="navbar-brand" href="{{ url_for('index') }}">MyApp</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarNav">
      <ul class="navbar-nav">
        <li class="nav-item">
          <a class="nav-link{% if request.endpoint == 'auth.edit_profile' %} active{% endif %}" 
             href="{{ url_for('auth.edit_profile') }}">
            编辑资料
          </a>
        </li>
        <li class="nav-item">
          <a class="nav-link{% if request.endpoint == 'main.dashboard' %} active{% endif %}" 
             href="{{ url_for('main.dashboard') }}">
            仪表盘
          </a>
        </li>
        <li class="nav-item">
          <a class="nav-link{% if request.endpoint == 'main.about' %} active{% endif %}" 
             href="{{ url_for('main.about') }}">
            关于我们
          </a>
        </li>
      </ul>
    </div>
  </div>
</nav>

✅ 关键要点说明：

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

• 使用 request.endpoint（非 request.url 或字符串比较）确保端点匹配精准，避免路径拼写、参数或 .html 后缀等干扰；
• Bootstrap 5 要求导航项使用
• 包裹 ，直接为 添加 active 类（而非
• ），否则样式可能不生效；
• 无需在每个子模板中设置 {% set active_page = ... %}，彻底消除同步遗漏风险；
• 若需支持蓝图嵌套或多级路由（如 admin.users.list），request.endpoint 仍可准确识别，扩展性强。

⚠️ 注意事项：

• 确保已正确配置 url_for() 的端点名（即 @bp.route(...) 对应的函数名或显式指定的 endpoint= 参数）；
• 在调试阶段可临时添加 {{ request.endpoint }} 到模板中查看当前值，快速验证端点命名是否一致；
• 若使用 Flask-Login 等扩展，request.endpoint 不受影响，可安全共用。

该方案简洁、健壮且符合 Flask 最佳实践，让导航状态管理回归服务端逻辑本质，真正实现“所见即所得”的活跃态体验。