网页端主题皮肤持久化需将用户选择(如dark/light)存入localStorage,并在页面加载时读取应用;通过CSS变量配合body类切换样式;读写时校验值合法性并处理异常,确保健壮性。

网页端实现主题皮肤配置的持久化,核心是把用户选中的主题(比如 dark 或 light)存进 localStorage,并在每次页面加载时读取并应用——这样刷新、关闭再打开,主题都不会丢。
页面加载时自动读取并应用主题
一进页面就要检查有没有存过主题。有就用它,没有就用默认值(比如浅色模式):
- 在
window.addEventListener('load', ...)或DOMContentLoaded中读取:const savedTheme = localStorage.getItem('theme'); - 如果值是
'dark',就给加上dark类;否则移除或保持默认 - 同时可同步更新切换按钮的 UI 状态(如图标、文字、选中态)
用户切换时及时写入 localStorage
当用户点击“深色模式”按钮,不只是改样式,还要把选择记下来:
- 用
localStorage.setItem('theme', 'dark')或'light'存储字符串值 - 推荐统一用小写英文命名键名(如
'theme'),避免大小写混淆 - 不建议存布尔值或数字,字符串最稳妥,也方便后续扩展(比如加
'sepia')
配合 CSS 类实现样式切换
不要直接改内联样式,而是用预设好的 CSS 类来控制整体外观:
- 在 CSS 中定义
body.light { --bg: #fff; --text: #333; }和body.dark { --bg: #121212; --text: #eee; } - HTML 中始终用
初始化,后续通过 JS 切换classList.add/remove - 所有颜色、背景、阴影都基于 CSS 变量,主题切换只需换类名,无需重写整套样式
增强健壮性的小细节
避免因存储异常或数据损坏导致白屏或错乱:
- 读取后做简单校验:
if (savedTheme === 'dark' || savedTheme === 'light') { ... },非法值就走默认 - 首次写入前可先清空旧键(非必须),或用
try...catch包裹写入操作,防止私密模式下 localStorage 不可用时报错 - 若支持系统偏好(
prefers-color-scheme),可在无本地存储时作为 fallback,但不覆盖用户主动选择


















