局部滚动条美化需满足两个硬条件：容器设overflow-y: auto且内容真实溢出；否则::-webkit-scrollbar伪元素不触发。
局部滚动条（比如 .chat-log、.modal-body 这类容器）能美化，但必须满足两个硬条件：容器自己设置了 overflow-y: auto（或 scroll），且内容真实溢出；否则所有 ::-webkit-scrollbar 规则都白写。
为什么给 .list-container 写了 ::-webkit-scrollbar 却没反应
根本原因不是 CSS 写错了，而是浏览器根本不触发该伪元素——它只认「实际滚动的块」，不继承、不全局生效。
-
.list-container没设height或max-height，导致内容没溢出，overflow-y: auto实际不生效 - 写了
overflow-y: auto，但父容器用了display: flex且没设flex-shrink: 0，高度被压缩，子容器拿不到滚动空间 - 伪元素只写了
::-webkit-scrollbar-thumb，漏了::-webkit-scrollbar-track—— Chrome/Edge 会直接弃用整套自定义，回退到原生样式 - 在 Safari（尤其是 macOS）里测试时误以为失效，其实 Safari 对局部容器的
::-webkit-scrollbar支持较弱，建议优先用 Chrome 验证
::-webkit-scrollbar 必须成套定义的三个部件
只控制宽度/颜色是不够的，缺一不可。每个部件都有强制要求：
-
::-webkit-scrollbar：设width（垂直）或height（水平），推荐8px–12px；小于6px可能被浏览器强制拉高 -
::-webkit-scrollbar-track：必须设background，否则透明，和页面底色混在一起；border-radius别超width / 2（例如width: 10px就别设border-radius: 6px） -
::-webkit-scrollbar-thumb：必须设background，否则滑块不可见；border-radius同样受限于尺寸，且悬停效果只能靠::-webkit-scrollbar-thumb:hover单独写
示例（可直接贴进项目）：
立即学习“前端免费学习笔记（深入）”；
.chat-log {
height: 400px;
overflow-y: auto;
}
.chat-log::-webkit-scrollbar {
width: 10px;
}
.chat-log::-webkit-scrollbar-track {
background: #f5f5f5;
border-radius: 5px;
}
.chat-log::-webkit-scrollbar-thumb {
background: #8a7bff;
border-radius: 5px;
}
.chat-log::-webkit-scrollbar-thumb:hover {
background: #6c5ce7;
}
Firefox 局部滚动条怎么处理
Firefox 完全无视 ::-webkit-scrollbar，而且它的 scrollbar-color 和 scrollbar-width **对局部容器无效**——只认 html 或带 overflow 的根级块（如 body），嵌套的 .chat-log 写了也白搭。
- 如果非要 Firefox 下也统一外观，唯一办法是 JS 库（如
simplebar），但它会替换原生滚动逻辑，可能影响键盘导航、屏幕阅读器支持和滚动性能 - 更现实的做法：接受 Firefox 局部滚动条保持原生样式，在 CSS 里明确注释说明，避免后续开发者反复折腾
- 若局部容器同时有水平和垂直滚动，Firefox 下
scrollbar-color无法分别控制方向，只能按整体配色
iOS Safari 和深色模式的隐藏陷阱
iOS Safari（含 iPadOS）**完全忽略所有滚动条 CSS**，无论你写多少 ::-webkit-scrollbar 或 scrollbar-color，它都当没看见——这不是 bug，是苹果明确不支持。
- 不要用 macOS Safari 测试 iOS 表现，两者渲染差异极大
- 深色模式下，WebKit 滚动条不会自动适配，必须手动为
@media (prefers-color-scheme: dark)重写整套::-webkit-scrollbar规则 - 想让局部滚动容器在 iOS 上也有惯性滚动？加
-webkit-overflow-scrolling: touch（虽已废弃但仍有实效），但仅限overflow-x: scroll场景
真正容易被忽略的是：局部滚动容器一旦用了 position: sticky 或 transform，某些版本 Safari 会直接禁用 ::-webkit-scrollbar 生效，连验证都看不到效果。
