rel="stylesheet"是浏览器加载CSS的唯一开关,必须显式声明;插入document.head可避免FOUC;需查重防止重复请求;onload/onerror非Promise且跨域失败静默,须手动兜底。

rel="stylesheet" 是浏览器加载 CSS 的唯一开关
浏览器只在 link 元素的 rel 属性严格等于 "stylesheet" 时,才会发起网络请求并解析样式规则。设成 rel="style"、rel="css",或漏写 rel,该标签就只是个普通 HTML 节点,不会触发任何加载行为。
实操建议:
- 必须显式写 link.rel = 'stylesheet',别依赖“默认值”或“应该能推断”
- 若需兼容 IE8 等极旧环境,补上 link.type = 'text/css';现代浏览器可省略
- 检查控制台 Network 面板:没看到对应请求,第一反应就是查 rel 值是否拼错或缺失
插入 document.head 才能避免 FOUC
把 link 插入 document.body 后,Safari 和部分旧版 Chrome 会延迟应用样式,导致页面先无样式渲染、再突然闪动(FOUC)。这不是 bug,而是规范要求——CSS 必须在 DOM 构建早期介入渲染流程。
实操建议:
- 一律用 document.head.appendChild(link)
- 不要用 document.body.appendChild(link) 或 insertBefore 找错锚点
- 若需控制顺序(比如确保在某个 UI 库样式之后),给已有 link 加 id 或 data-loaded,再按需调整插入位置
不查重会导致重复请求和样式冲突
单页应用中路由切换、组件反复挂载、热更新等场景下,同一份 CSS(如 theme.css?v=2.1.0)可能被多次插入。结果可能是两次请求、规则叠加覆盖、甚至因加载时机差异引发布局抖动。
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
实操建议:
- 插入前必须查重:document.querySelector(`link[href="${href}"]`)
- 对带版本号或时间戳的 URL,统一生成策略(如固定哈希、剔除查询参数),避免语义相同但字符串不同
- 若需切换主题,先 oldLink.remove() 再插入新 link,不要指望后加载的自动覆盖
onload/onerror 不是 Promise,跨域失败还静默
link.onload 和 link.onerror 是事件,不是可 await 的 Promise;直接写 loadCSS(url).then() 会报错。更关键的是:跨域 CSS 加载失败(如 403、CORS 拒绝)根本不会触发 onerror,只在控制台报 warning,JS 层完全感知不到。
立即学习“前端免费学习笔记(深入)”;
实操建议:
- 必须显式绑定两个事件:link.onload = () => {}、link.onerror = () => {}
- 跨域资源建议配合 fetch(href, { method: 'HEAD', mode: 'no-cors' }) 预检(注意 no-cors 下无法读响应状态,仅用于探测连接通路)
- 生产环境若用 CDN,优先走同域代理或开启 CORS,别依赖静默失败兜底
真正难的不是创建 link,而是让加载过程可观测、可竞态控制——尤其当多个模块各自尝试加载同一份 CSS 时,重复、时序、失败反馈都得靠手动兜住。

















