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 这类实色，否则在旧版上可能不认。

第三步：清空缓存并强制重载

按 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 的人机界面指南。

《夸克》非常好用的免费AI浏览器

下载APP查看