最高优先级执行暗黑模式防闪烁需在顶部使用内联同步脚本，立即读取localStorage或matchMedia并设置document.documentElement.dataset.theme或classList，确保首像素绘制前完成主题判定与应用。
要在暗黑模式防闪烁首屏脚本中以最高优先级执行 getElementById 注入，核心是让 DOM 查询和样式写入在浏览器解析 HTML 的最早可行时机完成——即在 中同步、阻塞式执行，且不依赖 DOMContentLoaded 或任何异步钩子。
把脚本放在 最顶部并设为 defer（但不用 async）
将防闪烁逻辑置于 内第一个 <script></script> 标签中，且不加 async（会异步加载破坏顺序），推荐用 defer（保证执行前 DOM 已构建到当前脚本位置，同时不阻塞 HTML 解析）。但注意：若必须「最高优先级」，应直接使用同步内联脚本（无 src），确保在 parser 遇到它时立即执行。
- ✅ 正确做法：在
开始处写内联<script>document.getElementById(...) || ...</script> - ❌ 避免：外部脚本 + async、或放在
底部、或包裹在DOMContentLoaded中 - ⚠️ 注意：此时
document.getElementById只能查到已解析的元素（如、、提前声明的<meta>或<link>等），所以目标元素需前置（例如）
用 document.documentElement 或 document.head 替代 getElementById（更早可用）
document.documentElement 和 document.head 在解析 和 标签后立刻可访问，比任何 getElementById 更早、更可靠。防闪烁关键操作（如写 class、设置 style.color）可直接作用于它们：
- 例如：
document.documentElement.classList.add('dark')或document.documentElement.style.color = '#fff' - 若必须用 ID，可在
上硬编码 ID，并在内联脚本中立即调用document.getElementById('root') - 无需等待
，避免白屏/闪动窗口期
配合媒体查询与 localStorage 实现零延迟判定
防闪烁的本质是「在首个像素绘制前就确定主题」。不能等 JS 加载后再读取 localStorage 或 matchMedia —— 这些必须在内联脚本中同步完成：
- 先读
localStorage.getItem('theme')，再 fallback 到window.matchMedia('(prefers-color-scheme: dark)').matches - 立即将结果写入
document.documentElement的 class 或 dataset：document.documentElement.dataset.theme = 'dark' - CSS 中用
[data-theme="dark"]提前定义样式，确保 CSSOM 构建时已有对应规则
避免重排重绘，只做最小必要 DOM 操作
最高优先级执行 ≠ 做最多事。频繁读写 offset/scroll 或触发 layout 的操作会拖慢首屏。注入逻辑应极简：
- 只做一件事：给
加 class 或 dataset - 不查
offsetHeight、不调getComputedStyle、不操作或后续节点 - 所有样式由纯 CSS 控制（如
html.dark { color: #fff; }），JS 不写内联 style - 这样整个脚本执行时间通常
