动态插入加载CSS失败主因是未正确处理异步加载过程。需用onload/onerror监听、验证路径与CORS、避免重复插入并合理缓存。
动态插入 标签加载 CSS 失败，通常不是代码没执行，而是加载过程没被正确处理——比如样式表还没加载完成就去操作 DOM，或路径、跨域、缓存等问题导致资源实际未生效。
确保 link 标签已正确插入并触发加载
仅创建 元素并 append 到 head 不代表样式立刻可用。浏览器需发起网络请求、下载、解析、注入样式表，这个过程是异步的。
- 用
link.onload监听加载成功（主流浏览器支持） - 用
link.onerror捕获 404、跨域拒绝等错误 - 避免在插入后立即读取
getComputedStyle或操作依赖该样式的元素
检查 href 路径与资源可访问性
相对路径容易出错，尤其在 SPA 或子目录部署时。
- 推荐使用绝对路径（如
/css/theme-dark.css）或完整 URL - 打开浏览器开发者工具 → Network 标签，筛选 CSS，确认请求状态码是否为 200
- 点击请求查看 Preview/Response，确认返回的是真实 CSS 内容，而非 404 页面或 HTML
注意 CORS 与协议一致性
若 CSS 文件来自其他域名，且服务器未设置 Access-Control-Allow-Origin，Chrome/Firefox 会静默阻止样式应用（控制台可能只报 warning，不报 error）。
立即学习“前端免费学习笔记（深入）”；
- 同协议、同域名最安全；跨域需服务端配合添加响应头
- 避免混用
http://和https://（如页面是 https，但 link 的 href 是 http，会被主动阻止） - 本地 file:// 协议下加载远程 CSS 会因 CORS 被拒，开发时建议用本地服务（如 vite preview、python -m http.server）
避免重复插入与缓存干扰
多次插入相同 href 的 link 标签不会报错，但可能引发冗余请求或样式覆盖混乱。
- 插入前先查重：
document.querySelector(`link[href="${href}"]`) - 开发阶段可在 href 后加时间戳或版本号（
?v=1.0.2）绕过强缓存 - 生产环境建议用内容哈希（如
theme.a1b2c3.css）实现长效缓存
基本上就这些。核心是把动态加载当成一个有生命周期的操作来对待——监听、验证、容错，而不是“插完就认为好了”。
