通过在模板中比对 `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>✅ 关键要点说明：
- 使用 request.endpoint（非 request.url 或字符串比较）确保端点匹配精准，避免路径拼写、参数或 .html 后缀等干扰；
- Bootstrap 5 要求导航项使用 <li class="nav-item"> 包裹 <a class="nav-link">，直接为 <a> 添加 active 类（而非 <li>），否则样式可能不生效；
- 无需在每个子模板中设置 {% set active_page = ... %}，彻底消除同步遗漏风险；
- 若需支持蓝图嵌套或多级路由（如 admin.users.list），request.endpoint 仍可准确识别，扩展性强。
⚠️ 注意事项：
- 确保已正确配置 url_for() 的端点名（即 @bp.route(...) 对应的函数名或显式指定的 endpoint= 参数）；
- 在调试阶段可临时添加 {{ request.endpoint }} 到模板中查看当前值，快速验证端点命名是否一致；
- 若使用 Flask-Login 等扩展，request.endpoint 不受影响，可安全共用。
该方案简洁、健壮且符合 Flask 最佳实践，让导航状态管理回归服务端逻辑本质，真正实现“所见即所得”的活跃态体验。
