横向导航栏需全部使用CSS变量（如--nav-bg、--nav-link-color等）驱动样式，确保在data-theme切换时实时响应；必须在:root定义默认值，并在html[data-theme="dark"] :root中覆盖深色值，且为hover/active等状态单独声明变量，避免硬编码或display:none导致闪动。
横向导航栏如何响应 data-theme 切换
横向导航本身不关心主题，但它的颜色、文字、边框、悬停态必须全部通过 CSS 变量驱动。硬编码值（如 color: #333）在切换时完全不会变——这是最常被忽略的根源。
必须确保导航容器（<nav></nav> 或 <header></header>）和所有子元素都使用 var(--nav-bg)、var(--nav-link-color) 等变量，且这些变量在两套主题下都有明确定义：
-
:root中定义浅色默认值：--nav-bg: #fff; --nav-link-color: #1a1a1a; -
html[data-theme="dark"] :root中覆盖深色值：--nav-bg: #121212; --nav-link-color: #e0e0e0; - 导航样式中只写：
background-color: var(--nav-bg); color: var(--nav-link-color);
漏掉 html[data-theme="dark"] :root 这层覆盖，或把变量写在 body.dark 下却没配对 :root，都会导致切换后无反应。
为什么导航 hover/active 态在深色模式下失效
hover 和 active 是独立状态，不能靠继承父级变量自动适配。很多项目只定义了 --nav-link-color，却没定义 --nav-link-hover-color 或 --nav-link-active-color，结果深色模式下鼠标悬停还是浅色蓝，甚至变成不可见的黑底黑字。
立即学习“前端免费学习笔记（深入）”；
正确做法是为每个交互态显式声明变量：
-
--nav-link-hover-color: #4285f4;（浅色下高亮蓝） -
html[data-theme="dark"] :root { --nav-link-hover-color: #66b2ff; }（深色下更亮的蓝，避免对比不足） - 链接样式中写：
color: var(--nav-link-color);，&:hover { color: var(--nav-link-hover-color); }
别用 filter: brightness() 模拟深色态——它会让箭头图标边缘模糊，且无法控制具体色相。
横向布局 + 主题切换的过渡卡顿问题
导航栏加 transition: background-color 0.3s, color 0.3s 很常见，但若同时用了 display: none 控制下拉菜单，在主题切换瞬间可能触发重排，造成闪动或错位。
解决方案很具体：
- 下拉菜单改用
visibility: hidden; opacity: 0;+transition: opacity 0.2s，避免 display 切换打断渲染流 - 导航容器自身不要加
transition: all，只精确列出需动画的属性（background-color、color、border-color） - 确保所有主题变量在
内联或首屏 CSS 中加载完毕，不要等 JS 动态注入
过渡时间超过 450ms 容易让用户感知延迟；低于 200ms 又显得生硬。300–350ms 是横向导航最稳妥的区间。
系统偏好与用户选择冲突时怎么处理
用户点了一次“切深色”，下次打开却回退到系统设置——这说明 localStorage 没生效，或读取时机错了。
关键逻辑必须严格按顺序执行：
- 页面刚加载，立刻读
localStorage.getItem('theme') - 有值就用它；没值才 fallback 到
window.matchMedia('(prefers-color-scheme: dark)').matches - 立即设
document.documentElement.dataset.theme = 'dark'（不是 class，data-theme 才能精准匹配 CSS 选择器） - 之后再监听按钮点击和系统变更事件
很多人把系统监听 matchMedia().addEventListener('change', ...) 放在按钮事件里，结果用户改了系统设置，网页毫无反应——监听必须在初始化阶段就注册，且每次回调都要同步更新 dataset.theme 和 localStorage。
