CSS滚动条原理与自定义样式指南，CSS滚动条样式失效，滚动条样式无效，-webkit-scrollbar无效，overflow不显示滚动条

滚动内容形成的必要条件

CSS Overflow属性解析

MDN官方文档-Overflow属性
菜鸟教程-Overflow属性

overflow 属性控制内容溢出元素框时在对应的元素区间内是否添加滚动条。

值	描述
visible	默认值。内容不会被修剪，会呈现在元素框之外。
hidden	内容会被修剪，并且其余内容是不可见的。
scroll	内容会被修剪，但是浏览器会显示滚动条以便查看其余的内容。
auto	如果内容被修剪，则浏览器会显示滚动条以便查看其余的内容。
inherit	规定应该从父元素继承 overflow 属性的值。

⚠️ 重要注意事项：

仅对明确设置高度的块级元素生效
MacOS系统默认隐藏滚动条（需滑动时才会显示，即使设置scroll值）

实现局部滚动需要满足两个核心条件：

容器具有确定的高度值（非auto）
设置overflow: scroll或overflow: auto

典型问题场景分析

<!DOCTYPE html>
<head><style>* {margin: 0;padding: 0;}.nav {width: 100%;height: 64px;background: lightcoral;}.main {/*这里的100%应该为100vh*/height: calc(100% - 64px);background: lightblue;}.content {height: 1300px;}</style>
</head><body><nav class="nav"></nav><main class="main"><div class="content"></div></main>
</body>
</html>

看起main被设置了高度，滚动条应该出现在main内，但实际运行会发现滚动条还是在body上的。

原因是：默认情况下，html 和 body 的高度由内容撑开，而非视口高度。

当 .main 设置 height: calc(100% - 64px) 时，100% 继承的是 body 的高度，而 body 的高度此时等于其内容高度（即 .nav 的 64px + .main 的内容高度），形成循环依赖。

所以解决办法就是

给body或html设定高度为100vh，
或把height: calc(100% - 64px)的100%设置为100vh

滚动条样式

浏览器兼容

目前(2025/2/20)，推荐使用老的::-webkit-scrollbar属性

因为新的属性没有旧的能改的多，像是圆角和hover之类

scrollbar-color: initial;
scrollbar-width

⚠️注意：设置了新的scrollbar-color和scrollbar属性会覆盖老webkit属性，导致webkit属性失效

* {/* 平滑锚点跳转时的滚动 */scroll-behavior: smooth;/*谷歌121版本后的新属性与旧webkit-scrollbar冲突*/scrollbar-color: initial;scrollbar-width: initial;
}/* 针对所有元素的Webkit内核浏览器滚动条进行全局样式设置 */
*::-webkit-scrollbar {height: 6px;    /* 水平滚动条的高度 */width: 6px;     /* 垂直滚动条的宽度 */
}/* 隐藏滚动条两端的箭头按钮 */
*::-webkit-scrollbar-button {display: none;  /* 不显示滚动条按钮 */
}/* 自定义滚动条滑块样式 */
*::-webkit-scrollbar-thumb {background-color: var(--scrollbar-color);  /* 使用CSS变量定义滑块颜色 */border-radius: 3px;                        /* 滑块圆角（半径是高度/宽度的一半） */
}/* 鼠标悬停时滑块的样式变化 */
*::-webkit-scrollbar-thumb:hover {background-color: var(--scrollbar-hover-color);  /* 悬停时使用更醒目的颜色 */
}/* 
注意事项：
1. 这些样式仅在Webkit内核浏览器生效（Chrome/Safari/Edge等）
2. --scrollbar-color 和 --scrollbar-hover-color 是CSS变量，需在根元素定义
3. 通过调整 width/height 值可以改变滚动条粗细
4. border-radius 设置为尺寸的一半会呈现胶囊形状
5. 通配符 * 表示应用于所有元素，可根据需要替换为特定选择器
*/