classList.toggle本身不触发CSS动画，需配合类名切换和正确的transition声明；必须在基础状态设transition: transform，起始transform值要明确，禁用display: none，JS只切类名不操作style。
classList.toggle 本身不触发 CSS 动画，必须配合类名切换 + 正确的 CSS 过渡声明才能实现侧滑展开动画。直接调用 classList.toggle('open') 而不写对样式，只会“闪现”或“无动画”。
为什么 toggle 后动画不生效？
常见错误是只写了 .sidebar.open { transform: translateX(0); }，但没声明过渡属性，或过渡作用在了错误的 CSS 属性上。
- 必须在基础状态（如
.sidebar）上写transition: transform 0.3s ease;，不能只写在.open类里 -
transform的起始值不能是unset或空，要明确设为translateX(-100%)或translateX(-300px) - 如果侧边栏有
display: none，动画会失效——display不可过渡，得改用visibility+opacity或固定宽高 +transform
HTML 和 JS 怎么配对写才可靠？
结构要保证侧边栏初始不可见但占位（或用 position: fixed 脱离文档流），JS 只负责切类名，不操作 style。
- 侧边栏容器加
class="sidebar"，默认transform: translateX(-100%); - 按钮绑定点击事件，执行
document.querySelector('.sidebar').classList.toggle('open'); - 避免用
getBoundingClientRect()或offsetWidth动态算宽度——CSS 里用max-width或width固定更稳
示例 JS：
立即学习“前端免费学习笔记（深入）”；
const sidebar = document.querySelector('.sidebar');
document.querySelector('.toggle-btn').addEventListener('click', () => {
sidebar.classList.toggle('open');
});
CSS 动画细节怎么调才顺滑？
关键不是加更多 keyframes，而是控制好 transform + transition 的组合方式。
- 用
transform: translateX()，别用left——后者会触发重排，卡顿明显 - 过渡时间建议
0.25s ~ 0.35s，太短像抽搐，太长像卡顿 - 加
will-change: transform;到.sidebar可提前启用 GPU 加速（尤其在低端安卓机上明显） - 如果内容区域也要“推挤”主内容，给主内容加
margin-left: 300px并同步 toggle 类，但更推荐用transform: translateX()移动整个 body，避免布局抖动
最容易被忽略的是：动画是否在 Safari 上失灵？检查是否漏了 -webkit-transform 前缀（iOS 15.4 之前仍需），以及 transform 是否被其他规则（比如 transform: scale(1)）意外覆盖。动手前先在 DevTools 里手动加删 open 类，确认 CSS 行为符合预期，再连 JS。
