如何解决Safari浏览器中自定义滚动条样式CSS无法生效的问题？

Safari 里 ::-webkit-scrollbar 写了一大堆却纹丝不动？别怀疑人生，这玩意儿绝对不是你家网络卡了，而是 Safari 对滚动条自定义的支持，藏了几个非常具体的硬性前提。今天来聊一个让不少前端头疼的问题，把那些踩过的坑一次性说清楚。

给一个 div 写了 ::-webkit-scrollbar 但看不到任何效果？先问自己：它真的在滚动吗？必须同时满足两个物理条件：【overflow 设置为 auto 或 scroll】 + 【内容的高度或宽度超出容器边界】。如果设的是 overflow: hidden 或 visible，伪元素根本就不会被浏览器渲染出来。

怎么排查？打开开发者工具，选中这个元素，在 Computed 面板里拉到最底下，确认 overflow 的值是不是 auto 或 scroll；再手动把窗口缩窄，或者往容器里塞更多内容，直到原生滚动条出现。这是所有自定义样式生效的物理基础，没这个基础，后面全白搭。

那具体怎么修呢？三步走。

第一步：把 ::-webkit-scrollbar 规则写在 html 元素或者具体的滚动容器上，不要只挂在 :root 或 body 上。Safari 16.4 及之后版本才开始支持 body::-webkit-scrollbar，旧版只认 html 或明确加了 overflow 的 div。

第二步：必须成对定义轨道和滑块。单独写 ::-webkit-scrollbar-thumb 却漏掉 ::-webkit-scrollbar-track，旧版 Safari 会直接回退到系统默认样式。特别注意：轨道的背景色别用 transparent，改用 #f5f5f5 这类实色，否则在旧版上可能不认。

第三步：清空 Safari 的专属缓存并强制重载。按 Option + Command + E 清理缓存，再进入“开发”菜单，选择“重新载入忽略缓存”，然后执行一次“清空缓存”。缓存损坏有时会导致 CSS 解析中断，样式表加载失败时页面会直接变成纯文字排版。

跨浏览器的写法也有门道。Firefox 和 Safari 的 CSS 滚动条风格大不相同，需要共存处理。

方法一：用 CSS 层叠覆盖，先写 Firefox 专用属性，再写 WebKit 规则。比如：

html { scrollbar-width: thin; scrollbar-color: #6c6c6c #f1f1f1; }
html::-webkit-scrollbar { width: 8px; }
html::-webkit-scrollbar-track { background: #f1f1f1; }
html::-webkit-scrollbar-thumb { background: #6c6c6c; border-radius: 4px; }

注意一个细节：scrollbar-color 的两个值顺序不能倒——第一个是滑块色，第二个是轨道色。写反了 Firefox 会当无效声明直接跳过。

方法二：用 @supports 做特性检测，避免污染不支持的浏览器。把 Firefox 和 WebKit 规则分别包在对应的特性检测里，互不干扰。

最后聊一个现实问题：iOS 设备。从 iOS 14 起，Apple 已经彻底移除了 ::-webkit-scrollbar 的支持。iPhone 和 iPad 上的 Safari 中，任何 CSS 滚动条样式都无效。这不是 bug，是 Apple 主动废弃的——系统认为触控滚动不需要视觉滚动条，强行显示反而会影响手指滑动体验。

如果项目必须在 iOS 上提供滚动感知，可以换一个思路：用顶部进度条代替。监听 scroll 事件，动态计算 scrollTop / (scrollHeight - clientHeight)，把结果映射成 #scroll-progress 元素的 width 百分比。这比用 JS 模拟滚动条轻量得多，而且完全符合 iOS 的人机界面指南。