Bootstrap面包屑分隔符不显示或错位，主因是伪元素::before未渲染或CSS变量--bs-breadcrumb-divider未生效；需检查content值、样式覆盖、变量声明位置及格式，并统一vertical-align和line-height修复对齐。
Bootstrap 面包屑分隔符不显示、错位或显示为方块，基本不是代码写错了，而是伪元素没渲染出来，或者 CSS 变量没生效——先看 DevTools 里 .breadcrumb-item + .breadcrumb-item::before 是否被计算、content 值是否为预期字符串。
检查 .breadcrumb-item + .breadcrumb-item::before 是否被覆盖或清空
这是最常被忽略的根源。Bootstrap 5 的分隔符完全依赖这个选择器生成，一旦它被设为 content: none 或 content: ""，分隔符就彻底消失，且不会报错。
- 打开浏览器 DevTools，选中任意一个非首项的
<li class="breadcrumb-item">，在 Styles 面板搜索::before - 确认该伪元素是否被划掉（表示被更高权重样式覆盖），或 computed 中
content显示为none - 全局搜索项目 CSS，排查是否有类似
.breadcrumb-item::before { content: none; }或重置类库（如某些 UI 框架的 base.css）悄悄清空了所有伪元素 - 若用 Sass/SCSS，检查是否误写了
.breadcrumb-item::before { content: null; }——CSS 不认null，会解析失败，导致 fallback 到空值
确认 --bs-breadcrumb-divider 变量是否正确设置且生效
Bootstrap 5.0+ 完全交由该变量控制分隔符，但必须满足三个硬性条件：变量值带英文双引号、声明位置在 Bootstrap CSS 之后、值是合法字符串而非 HTML 实体或未转义 Unicode。
- 内联设置要写成：
style="--bs-breadcrumb-divider: '>';"，不能是'>'、>或> - 全局设置推荐放在
:root，而不是.breadcrumb类上——后者无法被子元素继承 - Unicode 字符如 → 必须写成
"\2192"（双反斜杠），直接写"→"在部分构建工具（如 Vite + esbuild）中会被编码破坏 - 用
getComputedStyle(document.querySelector('.breadcrumb')).getPropertyValue('--bs-breadcrumb-divider')在控制台验证是否读取到预期值
响应式换行后分隔符悬空或错位
这不是分隔符本身的问题，而是伪元素默认按 baseline 对齐，而文字和符号基线不同；小屏换行后，line-height 计算偏差会被放大。
立即学习“前端免费学习笔记（深入）”；
- 不要只加
margin或padding调整位置——这治标不治本，缩放或字体变化时又偏了 - 统一加
vertical-align: middle和line-height: 1到伪元素上，强制脱离文本流对齐 - 如果用了 SVG 图标作分隔符，确保
height设为1em或1rem，并删掉 SVG 内部的fill属性，让它继承父级链接颜色 - 避免给
.breadcrumb-item设min-width或white-space: nowrap，否则 Flex 换行失效，分隔符被迫挤在单行末尾
用 SVG 替代字符时 URL 编码出错
--bs-breadcrumb-divider: url(...) 看似简洁，但任何未编码的 /、、空格都会让整个 URL 解析失败，结果分隔符变空。
- 别手写 data URL——用在线工具（如 svgomg.net）把 SVG 转成最小化 data URL，再 URL encode
- 常见错误：
--bs-breadcrumb-divider: url("data:image/svg+xml,<svg>...");</svg>—— 少了%3C（的编码），浏览器直接丢弃 - 更稳妥的做法：放弃变量，改用
.breadcrumb-item:not(:last-child)::after插入 inline<svg>，可控性更强，也绕过编码陷阱 - 若坚持用变量，测试时直接在控制台执行
document.documentElement.style.setProperty('--bs-breadcrumb-divider', 'url(...)')，比改 CSS 文件更快定位解析问题
真正难调的从来不是“怎么换符号”，而是“为什么换完没反应”——绝大多数情况，问题不出在你的 CSS 写法，而出在变量加载顺序、引号类型、或 DevTools 里那个被划掉的 ::before 规则上。
