检测css是否加载需查link/style节点并验证sheet属性;防重用set记录标准化url,注意跨域、hmr、路径一致性及错误处理。

如何检测页面是否已加载某个CSS文件
浏览器没有原生API直接告诉你 style.css 是否已注入,得靠手动标记或查询。最可靠的方式是检查 <link> 或 <style></style> 节点是否存在且 sheet 属性有效。
- 优先查
document.querySelector('link[href="style.css"]'),再判断其sheet是否非 null(注意:跨域 CSS 的sheet会是 null) - 动态插入的
<style></style>可通过id或data-loaded属性打标,避免重复创建 - 不要依赖
document.styleSheets的长度或顺序——它包含 UA 样式、内联样式,且顺序不稳定
重复加载同一CSS文件的典型后果
不是所有重复都会“报错”,但副作用很实在:HTTP 请求发了两次、样式规则被重复解析、@import 可能触发二次网络请求、甚至导致媒体查询或变量作用域异常。
- 如果用
fetch()+insertRule()动态加样式,重复执行会导致规则叠加,覆盖逻辑可能出人意料 - Webpack/Vite 的 HMR 机制本身会替换
<link>,若你手动又加一遍,旧节点残留,新旧样式共存 - 某些 CDN 会对相同 URL 做强缓存,看似没发请求,但 DOM 中仍多一个
<link>节点,影响后续选择器匹配性能
安全插入CSS的最小化封装函数
不需要引入整个 loader 库,几行代码就能防重。关键是把“加载动作”和“加载状态”解耦,用 Map 或全局对象记录已加载路径。
const loadedCSS = new Set();
function loadCSS(url) {
if (loadedCSS.has(url)) return;
const link = document.createElement('link');
link.rel = 'stylesheet';
link.href = url;
document.head.appendChild(link);
loadedCSS.add(url);
}
-
loadedCSS存的是原始url字符串,不处理相对路径转换——确保传入前已标准化(如用new URL(url, document.baseURI).href) - 不监听
link.onload:加载失败时,该url仍会被记为“已加载”,下次不会重试;如需容错,应配合link.onerror清除loadedCSS中对应项 - 避免用
document.head.querySelectorAll('link[rel="stylesheet"]')回溯判断——无法区分是代码插入还是 HTML 原生引入
构建工具场景下的CSS重叠风险点
Webpack 的 MiniCssExtractPlugin 和 Vite 的 css.inline 配置,会让 CSS 注入时机与手写 JS 不一致,容易在 SSR 或多入口场景下漏判。
立即学习“前端免费学习笔记(深入)”;
- Vite 开发模式下,HMR 会移除旧
<link>并插入新链接,但如果你在onMounted里反复调用loadCSS,可能抢在 HMR 完成前插入,造成瞬时双份 - Next.js App Router 中,
use client组件里动态loadCSS,若组件被多次挂载(比如 Tab 切换),Set是模块级的才管用,函数内声明的loadedCSS每次都是新的 - 微前端中,子应用各自管理 CSS 加载,主应用若也做同样事,必须约定统一的注册表(例如挂到
window.__LOADED_CSS__)
./style.css 和生产时 /static/style.a1b2.css 被当成两个文件,Set 就失效了。










