::-webkit-scrollbar 在 Chrome/Edge/Safari 中需父容器有 overflow: auto/scroll 且内容溢出才生效；Firefox 64+ 完全不支持，仅识别 scrollbar-width 和 scrollbar-color；iOS Safari 全不支持，旧 Edge 对 rgba 和圆角支持不稳定。
Chrome/Firefox 中 ::-webkit-scrollbar 为什么失效
直接写 ::-webkit-scrollbar 却没效果，大概率是缺了父容器的 overflow: auto 或 overflow: scroll。这个伪元素只对「实际触发滚动」的块生效，不是写了就渲染。另外，Firefox 从 64+ 开始已完全不支持 ::-webkit-scrollbar，它只认 scrollbar-width 和 scrollbar-color 这两个原生 CSS 属性。
实操建议：
- 先确认目标元素有明确高度 +
overflow-y: auto（或scroll），且内容确实溢出 - Chrome/Edge/Safari 用
::-webkit-scrollbar系列伪类控制样式 - Firefox 必须单独加
scrollbar-width: thin | auto | none和scrollbar-color: <thumb><track></track></thumb> - 不要依赖
::-webkit-scrollbar覆盖 Firefox —— 它压根不解析这些规则
SCSS 封装时如何处理多浏览器 fallback
不能把 WebKit 和 Firefox 规则混在同一个选择器里，否则 Firefox 会整个丢弃该样式块（因无法识别 ::-webkit-scrollbar）。正确做法是用 SCSS 的 @at-root 分离输出，或用 @supports 隔离。
推荐封装方式：
立即学习“前端免费学习笔记（深入）”；
- 用
@mixin scrollbar($thumb: #888, $track: #eee, $size: 8px)定义参数 - 内部用
@at-root分别输出 WebKit 块和 Firefox 块，避免交叉污染 - Webkit 部分包含
::-webkit-scrollbar、::-webkit-scrollbar-track、::-webkit-scrollbar-thumb三者组合 - Firefox 部分仅设
scrollbar-width: thin和scrollbar-color: $thumb $track，不写多余声明
示例片段：
@mixin scrollbar($thumb: #888, $track: #eee, $size: 8px) {
@at-root {
&::-webkit-scrollbar {
width: $size;
height: $size;
}
&::-webkit-scrollbar-track {
background: $track;
}
&::-webkit-scrollbar-thumb {
background: $thumb;
border-radius: $size;
}
}
@supports (scrollbar-width: thin) {
scrollbar-width: thin;
scrollbar-color: $thumb $track;
}
}
移动端 Safari 和旧版 Edge 的兼容性盲区
iOS Safari（包括 iPadOS）完全不支持 ::-webkit-scrollbar，也不支持 scrollbar-width。也就是说，你在桌面 Chrome 写得再漂亮，iPhone 上依旧显示原生灰条。旧版 Edge（EdgeHTML）虽支持 WebKit 伪类，但对 border-radius 和透明度支持不稳定。
应对策略：
- 移动端必须接受「无法自定义」的事实，别浪费时间调试 iOS 滚动条
- 如果项目强依赖滚动条视觉一致性，考虑用 JS 方案（如
simplebar或overlay-scrollbars），但注意 touch 事件和性能损耗 - 对旧 Edge，避免在
::-webkit-scrollbar-thumb中使用rgba()或hsla()，改用十六进制色值 - 所有圆角尺寸统一用
px，不用em或rem—— Safari 对单位解析不一致
SCSS mixin 中要不要加 !important
不要加。加了反而破坏可维护性，且解决不了根本问题。真正导致样式被覆盖的原因通常是选择器权重不足，或父级设置了 overflow: hidden 拦截了滚动行为。
更有效的做法：
- 确保调用
@include scrollbar的选择器足够具体，比如用.content-wrapper::-webkit-scrollbar而非泛泛的div::-webkit-scrollbar - 检查是否有全局重置样式（如 normalize.css 或某些 UI 库）强制设了
scrollbar-color: auto，需显式覆盖 - 若需强制生效，优先提升选择器权重（如加
body前缀），而不是堆!important
真正难搞的从来不是怎么写样式，而是判断「当前环境到底支不支持、支持到哪一步」——iOS 不支持、Firefox 只支持两个属性、旧 Edge 解析有 bug，这些边界条件比样式本身更消耗调试时间。
