自定义滚动条仅 WebKit 浏览器支持，Firefox 需 JS 库；推荐用 CSS 变量控制样式，结合 scrollbar-width: none 和 ::-webkit-scrollbar 隐藏滚动条；iOS Safari 限制多，需兼容处理。
滚动条自定义只在 WebKit 浏览器生效
Chrome、Edge、Safari（含 macOS/iOS）支持 ::-webkit-scrollbar 系列伪元素，Firefox 和旧版 IE 完全不识别——这不是兼容性“优化”问题，而是根本性限制。如果你的项目需支持 Firefox，得用 JS 滚动库（如 simplebar）替代原生滚动，CSS 方案只能作为 WebKit 下的增强。
实际开发中，先确认目标平台：内部管理后台？iOS/Android WebView？若含 Firefox 或需要统一行为，别浪费时间调 ::-webkit-scrollbar-track。
用 CSS 变量控制轨道与滑块颜色和尺寸
直接写死颜色值会让维护变麻烦，比如主题切换时要改多处。把颜色和尺寸抽成 CSS 变量，再通过 var() 注入到伪元素里，是最轻量的可控方式。
注意：伪元素本身不继承父级变量，必须在 :root 或滚动容器上定义，并确保作用域覆盖到 ::-webkit-scrollbar 所在选择器：
立即学习“前端免费学习笔记（深入）”；
:root {
--scrollbar-track-bg: #f5f5f5;
--scrollbar-thumb-bg: #c1c1c1;
--scrollbar-thumb-hover: #a0a0a0;
--scrollbar-size: 8px;
}
<p>.container {
overflow-y: auto;
}</p><p>.container::-webkit-scrollbar {
width: var(--scrollbar-size);
}</p><p>.container::-webkit-scrollbar-track {
background-color: var(--scrollbar-track-bg);
}</p><p>.container::-webkit-scrollbar-thumb {
background-color: var(--scrollbar-thumb-bg);
border-radius: calc(var(--scrollbar-size) / 2);
}</p><p>.container::-webkit-scrollbar-thumb:hover {
background-color: var(--scrollbar-thumb-hover);
}关键点：
-
border-radius推荐用calc(var(--scrollbar-size) / 2)实现圆角滑块，比写死4px更健壮 - 滑块 hover 状态必须显式定义，否则无反馈
- 不要给
::-webkit-scrollbar-track设border或padding，它只响应background-color和border-radius
隐藏默认滚动条但保留滚动能力
常见需求是“不显示滚动条，但能滚”，比如轮播图、横向卡片流。这时候不能用 overflow: hidden，而要用 scrollbar-width: none（Firefox） + ::-webkit-scrollbar 隐藏（WebKit）。
但注意：Firefox 的 scrollbar-width: none 是独立属性，和 WebKit 方案互不干扰，可共存：
.no-scrollbar {
scrollbar-width: none; /* Firefox */
}
<p>.no-scrollbar::-webkit-scrollbar {
display: none; /<em> Chrome/Safari/Edge </em>/
}</p><p>.no-scrollbar {
overflow-y: auto;
}这个组合能覆盖主流浏览器，且不影响鼠标滚轮、触控板、键盘方向键等所有滚动方式。
移动端 Safari 的特殊表现
iOS Safari 默认滚动条仅在滚动中短暂出现，且无法用 CSS 改变其颜色或宽度——::-webkit-scrollbar 在 iOS 16+ 之前完全无效；iOS 16+ 起部分生效，但 width 仍被忽略，滑块始终是系统固定宽度（约 12px），border-radius 也常失效。
所以如果你看到代码在桌面 Safari 正常，但在 iPhone 上没变化，不是写错了，是系统限制。此时更现实的做法是：接受原生样式，或用 overscroll-behavior: contain 配合 JS 模拟滚动容器。
真正容易被忽略的是：iOS 上 height: 100% 容器内滚动可能失效，务必检查父级是否设置了 min-height: -webkit-fill-available 或使用 vh 单位兜底。
