Skip to content

Vite 8 入口 HTML CSS 与动态 mapDeps preload 会重复插入两份 style #1108

Closed

Description

@KeyToLove

问题现象

Vite 8 生产构建的子应用,同一份 CSS 会在无界里变成两份 <style>。若这份 CSS 只含组件默认宽高、业务原子类在另一份入口 CSS 里,后插入的默认值会盖住原子类。

链路:

  1. 子应用 index.html 已有静态 <link rel="stylesheet" href="assets/shared.css">
  2. 无界解析入口 HTML 后,把该 link 转成 <style>/* url */...</style>
  3. 异步 import() 的 __vite__mapDeps 再 document.createElement('link') 并 appendChild 同一 href
  4. 无界再次转成 <style>
  5. 同一规则两份;默认宽高与原子类不在同一文件时,后一份盖住原子类

最小复现(Vite 8.2.2 + Wujie 2.1.0):

https://github.com/KeyToLove/wujie-vite8-css-dup-demo

复现要点:

  • shared.css:仅 .box { width/height: 100% },进 HTML,也进异步 mapDeps
  • atomic.css:仅 .w-240 / .h-200,只进 HTML,不进 mapDeps

未打补丁时:

  • 诊断里 matchingStyleCount >= 2(两份含 .box 的 <style>)
  • boxSize 不是 240×200,红块被撑开

若把默认宽高和原子类写在同一份 CSS 里,整份插两次层叠顺序不变,方块仍可能是 240×200,但 matchingStyleCount 仍为 2,重复插入已经发生。

原因分析

动态插入在 loadStyleSheet:2.1.0 会立刻创建占位 <style data-wujie-css-href>,避免 fetch 完成前再次动态 append 同一 link。这与 changelog「修复异步加载 CSS 时重复插入」一致。

当前故障是另一条路径:

  • getEmbedHTML 仍生成 <style>/* ${src} */${content}</style>,没有 data-wujie-css-href
  • loadStyleSheet 在 createElement('style') 之前不查找 已有节点
  • Vite runtime 去重只认 link[rel=stylesheet][href],认不出已经转成的 <style>

因此 HTML 已嵌入的 CSS 与后续 mapDeps preload 不是子集关系,而是同一 asset 被转换两次。

2.1.0 发布包里注释提到 checkLinkAndLoad,源码中没有该函数实现。

已检索的相近 issue

  • 子应用 CSS 文件重复加载 #878 :子应用 HTML 外链 CSS 与 JS 动态导入同一文件,shadowRoot 中出现两份样式。根因描述与本问题同向(入口 HTML 解析一次 + JS 再请求一次),该 issue 未给出 Vite 8 mapDeps 复现,也未说明 2.1.0 占位逻辑为何挡不住这条路径。

未找到已关闭且已修复本路径的 issue。

建议修法

  1. getEmbedHTML 非 ignore 时给内联 style 加上 data-wujie-css-href(与动态占位同一查找键)。
  2. loadStyleSheet 插入前按该属性和注释 /* href */ 查找;命中则不再插入,但仍对原 link 派发 load(Vite preload 依赖该事件)。
  3. 动态插入成功后也设置 data-wujie-css-href,写在复制原始 attrs 之后。

Activity

  1. added a commit that references this issue on Nov 10, 2026
  2. yiludege commented on Nov 13, 2026

    @yiludege
    Collaborator

    入口 HTML 和 Vite __vite__mapDeps 各转一份 <style> 这条链路是对的。#1109 用 data-wujie-css-href 去重,并在命中后异步补 load。

    审查里还有两点要收:正在拉取的占位 style 不要立刻派发 load;内容为空的成功 CSS 不要被当成失败。这两点改完再看合入。

  3. KeyToLove commented on Nov 13, 2026

    @KeyToLove
    ContributorAuthor

    审查里的两点已在 #1109 收掉:正在拉取的占位 style 不再立刻派发 load,空 CSS 成功也不会再被当成失败。

  4. added a commit that references this issue on Nov 14, 2026
    f24456d
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions