响应式侧边栏偏移量应通过 CSS 变量 --sidebar-width 统一控制，主内容区用 transform: translateX(var(--sidebar-width)) 实现无重排偏移，并配合 transition 动画；变量须定义在 :root 或共同祖先作用域，JS 交互时应修改变量而非直接操作 transform。
transform 的 translateX 值该从哪来
响应式侧边栏的偏移量不是靠猜，而是靠 CSS 变量联动控制。核心逻辑是：侧边栏展开时，主内容区向右平移一个侧边栏宽度；这个宽度不能写死，否则无法适配不同断点或主题下的尺寸变化。
常见错误现象：transform: translateX(250px) 硬编码，在移动端侧边栏收起后主内容仍被固定偏移，或在暗色模式下宽度不一致导致错位。
- 用
--sidebar-width作为统一变量，所有相关尺寸（width、transform、margin-left）都基于它计算 - 在媒体查询中动态改写该变量值，比如
@media (max-width: 768px) { :root { --sidebar-width: 0; } } - 主内容区的
transform: translateX(var(--sidebar-width));必须配合transition: transform 0.3s ease，否则无动画
为什么不能只靠 width 或 margin 实现偏移
单纯设置 margin-left 或 width 会破坏文档流布局，尤其当主内容内有 position: sticky 元素或 flex 子项时，偏移量可能被忽略或叠加异常。
使用 transform 是安全的——它不触发重排（reflow），只影响渲染层，且能精准复用同一变量值，和侧边栏的 width 保持数学一致性。
立即学习“前端免费学习笔记（深入）”；
-
transform不影响其他元素布局，margin会挤压相邻块级元素 - 如果侧边栏用
flex布局，margin-left在某些 flex 容器中会被压缩或忽略 - 浏览器对
transform的硬件加速支持更稳定，滚动时不易卡顿
CSS 变量作用域和计算时机问题
CSS 变量不是“实时计算”的表达式，var(--sidebar-width) 只取当前作用域下已声明的值。如果你在子元素里改写了变量，父元素的 transform 不会自动响应。
典型翻车场景：.sidebar.is-collapsed { --sidebar-width: 0; } 写在侧边栏自身上，但主内容区的 transform 声明在 :root 或父容器，结果偏移量不变。
- 变量必须定义在共同祖先作用域（通常是
:root或body），确保主内容和侧边栏都能读取到同一份值 - 切换状态时，优先用 class 切换整个页面的根变量，例如
body.sidebar-open { --sidebar-width: 280px; } - 避免在
@keyframes中引用未在动画作用域声明的变量，会导致计算为initial
移动端触摸拖拽时 transform 偏移失效
当侧边栏支持手势拖出（如滑动打开），直接操作 transform 值容易和 CSS 动画冲突，造成视觉跳变或卡住。
根本原因是：JS 修改 style.transform 会覆盖 CSS 中的 transform 声明，后续 CSS 变量更新无法生效，除非 JS 主动同步。
- 用
element.style.setProperty('--sidebar-width', '220px')替代直接写transform，让 CSS 自行计算 - 监听 touchmove 时，只更新变量值，不碰
transform属性本身 - 若需高性能拖拽，可搭配
will-change: transform，但仅在拖拽中临时添加，拖完立刻移除
