直接选 bootstrap-flask，它自动处理资源加载顺序、依赖（如 popper）、integrity 属性和 jinja2 block 管理，避免手动引入时漏 jquery/popper、错序或缓存问题；flask-bootstrap 已淘汰，仅支持 bootstrap 3 且不兼容新版 flask 和 wtforms。
用 bootstrap-flask 还是手动引入 Bootstrap 文件？
直接选 bootstrap-flask，除非你明确需要自定义某份 CSS/JS 的加载顺序、版本或 CDN 源。手动把 bootstrap.min.css 和 bootstrap.bundle.min.js 放进 static/、再在模板里 <link> 和 <script></script> 引入，看似“可控”，实则容易漏掉 jQuery（Bootstrap 4）或 Popper（Bootstrap 5）、搞错依赖顺序、忘记响应式 meta 标签，甚至因缓存导致新版 JS 不生效。
而 bootstrap-flask 在初始化时自动注入正确资源路径和顺序，并通过 Jinja2 的 styles 和 scripts block 管理加载位置，连 integrity 和 crossorigin 属性都默认带上（若启用 CDN 模式）。它不黑盒，源码就在 flask_bootstrap/static/ 下，可随时 inspect。
render_form() 渲染失败的三个常见原因
调用 {% from 'bootstrap5/form.html' import render_form %} 后表单没样式、字段错位、错误信息不显示——通常不是宏本身问题，而是上下文缺失：
- 表单类没继承
FlaskForm（比如用了纯Form），render_form依赖 WTForms 的__iter__和errors接口 - 视图函数没把表单实例传给模板：
return render_template('login.html', form=LoginForm())缺了form=... - 模板中漏了 CSRF token：即使没显式写
{{ form.csrf_token }}，render_form也会尝试渲染，但若SECRET_KEY未配置，整个表单会静默崩溃（无报错，只渲染空白）
Bootstrap 4 和 Bootstrap 5 在 Flask 中的关键差异点
别只看 CSS 类名变化，Flask 集成层有实际影响：
-
Bootstrap4类依赖 jQuery，必须确保jquery.min.js在bootstrap.bundle.min.js之前加载；Bootstrap5类完全移除 jQuery，但要求 Popper（已含在bootstrap.bundle.min.js中） - 表单验证提示方式不同：Bootstrap 4 用
.has-error+<span class="help-block"></span>；Bootstrap 5 改用:invalid伪类 +<div class="invalid-feedback">，<code>render_form会自动适配，但自定义验证逻辑若硬写 class 就可能失效 - 导航栏折叠行为：Bootstrap 5 移除了
data-toggle，改用data-bs-toggle，bootstrap-flask的render_navbar宏已更新，但手写 HTML 时容易沿用旧属性导致汉堡菜单不展开
为什么 flask-bootstrap 扩展该淘汰了
flask-bootstrap（注意包名无 dash）最后更新是 2019 年，仅支持 Bootstrap 3，且与 Flask 2.3+ 的 app.app_context() 初始化机制存在兼容问题。它不支持 WTForms 3.x 的新验证器语法，render_form 宏缺失对 FieldList 和 FormField 的递归渲染能力。社区早已转向 bootstrap-flask，后者持续维护、CI 覆盖 Flask 2.2–3.0、WTForms 2.3–3.1、Python 3.8–3.13，且文档示例全部基于真实项目结构。
如果你在老项目里看到 from flask_bootstrap import Bootstrap，别犹豫，立刻替换为 from flask_bootstrap import Bootstrap5 并检查 templates/bootstrap5/ 下的宏引用路径——这才是当前最省心、最不易踩坑的集成方式。
