WordPress中用Bootstrap做主题，关键在于协调二者机制：data-bs-*属性被wp_kses_post()过滤、jQuery依赖未满足致$未定义、Navwalker不兼容BS5、wpautop破坏栅格结构，需通过放行过滤、显式JS初始化、正确排队及结构管控解决。
WordPress 里用 Bootstrap 做博客主题，不是“能不能用”，而是“在哪用、怎么控、谁来管”——它能快速搭出响应式结构，但默认行为和 WordPress 的运行机制天然冲突，不干预就会出问题。
data-bs-* 属性点击没反应？wp_kses_post() 在后台悄悄删了你的属性
比如 data-bs-toggle="collapse" 点击后菜单不动，data-bs-dismiss="modal" 关不掉弹窗。这不是 JS 没加载，也不是 CDN 失效，而是 WordPress 在保存文章/页面内容时，用 wp_kses_post() 过滤 HTML，把所有 data-bs-* 开头的自定义属性当“不安全标签”直接清除了。
- 临时绕过：在
functions.php中用add_filter('wp_kses_allowed_html', ...)手动放行data-bs-*，但仅限可信编辑者使用 - 更稳妥做法：把交互逻辑从纯 HTML 属性移到 JS 初始化中，例如用
new bootstrap.Collapse(...)显式调用，避开属性依赖 - 注意：自定义字段（ACF）、区块编辑器（Gutenberg）中插入的 HTML 同样受此限制，不能只改 classic editor
wp_enqueue_script 加了 bootstrap.bundle.min.js 却报 $ is not defined
错误信息是 $ is not defined 或 jQuery is not defined，说明 Bootstrap 的 JS 在 jQuery 之前执行了——即使你写了 array('jquery')，WordPress 仍可能因队列顺序或脚本异步加载打乱依赖。
- 确认
wp_enqueue_script('jquery')没被主题或插件禁用或替换（比如用wp_deregister_script('jquery')） - Bootstrap 脚本必须设
$in_footer = true，否则在<head>中加载时，jQuery 可能还没注入（尤其某些主题把 jQuery 放在 footer） - 避免混用 CDN 和本地文件：CDN 地址若带 SRI（integrity 属性），而本地路径没配对，会导致浏览器拒绝执行
- 检查控制台 Network 面板，确认
jquery.js和bootstrap.bundle.min.js的加载顺序与状态码（200 / 404 / 304）
Bootstrap 导航菜单下拉项在移动端点不开
桌面正常，手机点 navbar-toggle 没反应，或下拉菜单展开后立刻收起——常见于没正确集成 WP_Bootstrap_Navwalker，或用了过时的 data-toggle 写法。
- Bootstrap 5 已废弃
data-toggle，必须用data-bs-toggle；旧版 Navwalker（如针对 BS4 的）会输出错误属性，导致 JS 不识别 - 确保使用的 walker 类明确支持 Bootstrap 5，例如
bootstrap_5_wp_nav_menu_walker，而非WP_Bootstrap_Navwalker（后者默认为 BS4） -
wp_nav_menu()中的'depth' => 2是硬性限制，超过二级的菜单项不会渲染，不是 JS 问题 - 移动端折叠容器 class 必须含
collapse，且与data-bs-target的选择器完全匹配（如.navbar-collapse对应data-bs-target=".navbar-collapse"）
为什么 Bootstrap 的栅格类（如 col-md-6）在文章正文里不生效
你在文章编辑器里写了 <div class="row"><div class="col-md-6">左</div><div class="col-md-6">右</div></div>，但前端显示为垂直堆叠——根本原因是 WordPress 默认用 wpautop() 给段落加 <p>，破坏了 Bootstrap 的父子结构语义。
- 不要在 classic editor 的可视化模式里写栅格，切到“文本”模式并关闭自动段落（用
remove_filter('the_content', 'wpautop');仅对特定 post type 生效） - Gutenberg 编辑器中，用「自定义 HTML」区块写栅格，或安装支持 Bootstrap 的区块插件（如 Kadence Blocks），别依赖原生段落区块
- 如果主题启用了
apply_filters('the_content', ...)多次，可能导致wpautop()被重复执行，进一步污染 HTML 结构
最易被忽略的一点：Bootstrap 的 CSS 和 JS 行为高度依赖 DOM 结构完整性，而 WordPress 的模板层级、过滤器链、编辑器处理流程会持续改写 HTML。与其反复调试 data-bs 属性或栅格塌陷，不如从一开始就决定哪些交互交由 Bootstrap 管，哪些交给 WordPress 原生机制（比如用 wp_nav_menu() 渲染菜单结构，再用 Bootstrap 类修饰，而不是手写 navbar HTML）。
