Vue 项目字体文件打包后 fonts 文件夹“消失”？原因分析与解决方案

在 Vue 项目中，将字体文件放在 src/assets/fonts 目录下，打包后在浏览器中访问发现路径里"不见了 fonts"文件夹，这通常不是文件丢失，而是 Vue 的构建工具（Webpack 或 Vite）对静态资源进行了自动化处理。

导致这种情况主要有以下两个原因：

🔍 原因一：小体积字体被转成了 Base64（最常见）

Vue 的构建工具默认会对 assets 目录下的静态资源进行优化。如果你的字体文件体积较小（例如小于 4KB 或 8KB，具体取决于配置），构建工具会直接将其转换成 Base64 编码的字符串，并内嵌到打包后的 CSS 文件中。

• 现象 ：浏览器访问时，根本不会发起对 .woff 或 .ttf 字体文件的网络请求，因为字体数据已经包含在 CSS 里了。
• 结论：这是正常的优化机制，能减少 HTTP 请求次数，提升加载速度，无需修复。

🔍 原因二：文件被重命名并提取到了根目录

如果字体文件较大，构建工具会将其作为独立的资源文件打包。为了防止浏览器缓存 导致更新不生效，构建工具默认会给文件名加上一串哈希值（如 MyFont.a1b2c3d4.woff）。同时，根据你的打包配置，这些资源可能会被直接提取到 dist 的根目录或 static 目录下，而不再保留原本的 fonts 文件夹结构。

• 现象 ：在浏览器 Network 面板中看到的请求路径可能是 /a1b2c3d4.woff，而不是 /fonts/MyFont.woff。
• 结论：只要浏览器能正常加载出字体（状态码 200），且页面上字体显示正常，就说明路径解析是成功的。

---

🛠️ 如果你确实需要保留 fonts 目录结构

如果你希望打包后的路径严格保持 /fonts/xxx.woff 的结构，可以通过以下两种方式解决：

方案 1：将字体文件移至 public 目录（推荐）

public 目录下的文件在打包时会原封不动地复制到 dist 目录，不会经过构建工具的处理（不会被转 Base64 或重命名）。

1. 在根目录的 public 文件夹下新建一个 fonts 文件夹，将字体文件放进去。
2. 在 CSS 中使用绝对路径引用：

@font-face {
  font-family: 'MyFont';
  /* 这里的 /fonts/ 对应 public/fonts/ */
  src: url('/fonts/MyFont.woff2') format('woff2');
}

方案 2：修改构建配置（针对 Webpack/Vue CLI）

如果你坚持使用 src/assets，可以在 vue.config.js 中修改 url-loader 或 file-loader 的配置，强制指定输出目录并关闭 Base64 转换（将 limit 设为 0）：

// vue.config.js
module.exports = {
  chainWebpack: config => {
    const fontsRule = config.module.rule('fonts');
    fontsRule.uses.clear(); // 清除默认配置
    fontsRule
      .test(/\.(woff2?|eot|ttf|otf)(\?.*)?$/i)
      .use('url-loader')
      .loader('url-loader')
      .options({
        limit: 0, // 关闭 Base64 转换
        name: 'fonts/[name].[hash:8].[ext]' // 强制输出到 fonts 目录下
      });
  }
};

💡 建议：

你可以先打开浏览器的开发者工具（F12），切换到 Network（网络） 面板，刷新页面查看字体文件是否返回了 200 状态码。如果字体能正常显示且没有报 404 错误，建议保持现状即可，这属于构建工具的正常优化行为。