初月_Yuechu

构建阶段的外部依赖是隐藏风险#

很多构建流程看起来是「本地执行」，实际上仍然依赖远程资源：字体、图标、封面图、第三方数据。只要其中任何一个不可达，构建就会中断。

把字体放回本地#

解决方式不是给 CDN 加重试，而是把字体文件放进仓库，改用本地数据源：

1
{
2
  id: "outfit-body",
3
  family: "Outfit",
4
  role: "body",
5
  source: "local",
6
  variants: [
7
    { file: "src/assets/fonts/outfit-latin-400-normal.woff2", weight: 400 },
8
    { file: "src/assets/fonts/outfit-latin-500-normal.woff2", weight: 500 },
9
    { file: "src/assets/fonts/outfit-latin-700-normal.woff2", weight: 700 },
10
  ],
11
}

改完之后，构建不再请求外部字体地址，失败问题也随之消失。

子集化不等于可以随便加字体#

中文全量字体动辄几 MB，即使子集化，多个字重叠加也会迅速膨胀。本站的字体预算约为 6 MB，实际构建后约 844 KB，仍然有空间，但不能无节制地增加。

字体优化的第一步不是压缩，而是删掉不需要的字重。

中文字重的现实限制#

本站使用的中文字体只有一个 Medium 字重。标题需要的 600/700 会由浏览器合成，效果不如真实字重扎实。

这次故障留下的经验#

• 构建流程里尽量不依赖远程资源；
• 能本地化的资源就本地化；
• 出问题时先看「构建阶段请求了什么」，而不是只盯着报错行。

字体问题看起来很小，但它提醒我：网站能否构建成功，取决于最薄弱的那条外部链路。把链路收回来，心里才踏实。