闪屏本质是主题 css 加载滞后导致的样式 重绘 —— 浏览器 先渲染默认样式，再等新 CSS 下载、解析、应用，中间出现视觉断层。解决核心思路是：让目标主题的 CSS 资源在切换前就就绪，切换时只改 class 不等资源。
闪屏本质是主题 CSS 加载滞后导致的样式重绘——浏览器先渲染默认样式，再等新 CSS 下载、解析、应用，中间出现视觉断层。解决核心思路是：让目标主题的 CSS 资源在切换前就就绪，切换时只改 class 不等资源。
预加载所有主题 CSS 文件
把深色、浅色等主题的 CSS 都提前通过 引入，用 rel=”preload” 或rel=”stylesheet”（配合 media=”print” 或disabled属性）避免阻塞渲染，同时确保资源已缓存。
- 推荐写法：
<link rel="preload" href="theme-dark.css" as="style" onload="this.onload=NULL;this.rel='stylesheet'"> - 或统 一加 载但初始禁用：
<link id="theme-dark" rel="stylesheet" href="theme-dark.css" disabled>，切换时移除 disabled 并切换 body class - 避免用 @import 或动态 fetch+insertRule，它们无法被预加载且执行延迟高
切换时仅操作dom class，不触发布局重排
确保主题 CSS 中所有 选择器 都基于一个顶层 class（如 .theme-dark），且不依赖 属性选择器 或js内联样式。切换时只给 html> 或加 / 删 class，浏览器 直接复用已解析的规则。
- ✅ 正确示例：
document.documentElement.classlist.toggle('theme-dark') - ❌ 错误做法：用 JS 逐个修改元素 style.color 等，触发强制同步布局
- 注意：CSS 变量（:root {–bg: #fff;}）也适用此方式，只需在对应 class 下重定义变量值
利用 CSS 媒体查询兜底系统偏好
用户首次访问时，用 @media (prefers-color-scheme: dark) 自动匹配系统主题，并配合 JS 同步设置初始 class，避免白屏 / 黑屏等待。
- 在 CSS 中写：
@media (prefers-color-scheme: dark) {:root { --theme: 'dark';} } - JS 读取：
const systemTheme = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';，立即设 class - 这样用户打开页面瞬间就是目标主题，无过渡空白
可选：添加轻量级淡入过渡（非必需）
如果仍想视觉柔和，不用依赖 CSS 加载，而是用 opacity 过渡——初始 body 设opacity: 0，主题 class 就绪后 10ms 内渐显，全程不闪。
立即学习 “ 前端免费学习笔记（深入）”；
- CSS 中定义：
body {opacity: 0; transition: opacity 0.15s ease; } body.ready {opacity: 1;} - JS 在 DOM ready + 主题 CSS 加载完成后加 ready 类（可用 document.fonts.load 或link.sheet.cssRules检测）
- 注意：过渡时间别超过 200ms，否则影响感知响应速度
