uni-app小程序端动态加载主题css的唯一可行方法是：先用uni.downloadfile下载css文件到临时路径，再用uni.readfile读取内容，最后创建style标签并注入document.head；需注意ios临时文件有效期短、dom操作时机敏感、必须清理旧样式以避免fouc。
uni-app小程序端主题CSS文件如何动态加载
不能直接用 import 或 require 加载远程 CSS，也不能靠 uni.loadSubNVue 或 uni.navigateTo 触发样式注入。真正可行的路径只有一条：手动创建 <link> 标签插入 ，并确保 URL 可被微信小程序合法访问（即必须是 HTTPS、已配置 downloadFile 合法域名，且不能带 query 参数干扰缓存）。
为什么 addcssfiles 在小程序里大概率失败
常见错误现象：DOMException: Failed to execute 'insertBefore' on 'Node'，或控制台静默无反应，主题样式完全不生效。
- 微信小程序 WebView 不支持原生
document.head操作，document.getelementsbytagname('head')返回null—— 这是 uni-app 小程序端最常踩的坑 - 即使绕过 DOM 检查强行 append，iOS 端对
<link rel="stylesheet">的解析有延迟甚至忽略，尤其当 URL 带版本号（如theme-v2.1.css?ts=1718234567）时极易失效 - uni-app 的
vue-style-loader会劫持所有 style 标签，远程 CSS 若未在编译期声明，可能被过滤或降权
正确做法：用 plus.webview.currentWebview.appendCSS（仅 App）+ 小程序专用 fallback
小程序端没有 appendCSS，必须走兼容路径：
- 使用
uni.downloadFile先把主题 CSS 下载到本地临时路径（tempFilePath），再用uni.loadFontFace类似思路——但注意：CSS 不支持loadFontFace，所以只能退到「下载 → 读取内容 → 动态写入<style></style>」 - 关键代码片段：
uni.downloadFile({ url: 'https://cdn.example.com/themes/dark.css', success: (res) => { if (res.statusCode === 200) { uni.readFile({ filePath: res.tempFilePath, encoding: 'utf8', success: (readRes) => { const style = document.createElement('style') style.textContent = readRes.data document.head.appendChild(style) } }) } } }) - ⚠️ 注意：
readFile读取的是临时路径，iOS 上tempFilePath有效期极短（约 30 秒），必须立即读取并注入，不可缓存路径后续再用
主题切换时如何避免样式残留和 FOUC
动态加载新主题前，必须清理旧主题影响，否则会出现样式叠加、优先级错乱、字体闪烁等问题。
- 不要只删
<style></style>标签：需同时清除所有由主题注入的 class（如theme-dark）、CSS 变量（:root { --primary: #333 }）和 media 查询规则 - 推荐做法：给每个主题
<style></style>打上唯一 ID（如id="theme-css-dark"），切换时先document.getElementById('theme-css-dark')?.remove()，再注入新 style - FOUC（闪白）无法完全避免，但可缓解：在
app.vue的onLaunch阶段预加载默认主题，并用v-show控制根容器显示时机，等style插入完成后再show - 性能提示：单次注入 CSS 内容不宜超过 20KB，否则 iOS WKWebView 可能卡顿或丢帧
最易被忽略的一点：微信小程序对 document.head.appendChild 的调用时机极其敏感——必须确保 DOM 已 ready，且不能在 onLoad 之前执行；onShow 或 onReady 是安全边界，onLaunch 中操作 head 极可能失败。
