# Google Fonts

> 分类：`libs/ui/` · 档位：**评估** · 更新时间：2026-11-17

## 1. 基本信息

| 项 | 内容 |
|---|---|
| 类型 | 字体分发服务（CSS API + woff2 CDN），不是 JS 库 |
| 版本 | CSS API v2（持续更新，无固定版本号） |
| License | 服务免费；字体本身多为 SIL OFL / Apache-2.0 |
| 维护方 | Google |
| 文档 | https://fonts.google.com · https://developers.google.com/fonts/docs/css2 |

## 2. 一句话定位

最省事的 Web 字体来源：一行 `<link>` 引入上千款开源字体，自动按浏览器与语言切片返回 woff2。
代价是第三方请求、隐私合规与特定地区（如中国大陆）的网络可达性。

## 3. 体积

| 引入方式 | 大小 | 说明 |
|---|---|---|
| CSS 响应 | 约 1–3 KB | 按 UA 返回不同 `@font-face` |
| 单个拉丁字重（woff2） | 约 15–50 KB | 可变字体可合并多字重 |
| 中文等 CJK | 按 unicode-range 切片 | 单页通常只加载用到的若干切片 |

无 JS 运行时；实际体积取决于字体、字重数量与是否用可变字体。

## 4. 核心 API

```html
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600&display=swap" rel="stylesheet">
```

```css
body { font-family: "Inter", system-ui, sans-serif; }
```

可变字体写法：`family=Inter:wght@100..900`。

## 5. 适用 / 不适用

- **适用**：原型、营销页、需要多语言字形覆盖的项目；不想自己管字体文件时。
- **不适用**：隐私合规敏感（欧盟）、内网/离线、对首屏与稳定性要求极高的站点——这些场景应自托管。

## 6. 硬缺口与已知坑

- 第三方请求：DNS + TLS + 字体下载多一跳，弱网下 FOUT/CLS 明显。
- 隐私合规：欧盟曾有判例认定直接引用构成个人数据转移，部分项目因此改自托管。
- 中国大陆访问 `fonts.googleapis.com` 不稳定，公开面向国内用户的站点应自托管或换镜像。
- 字重与字族开太多会成倍增加体积，优先可变字体 + 2–3 个字重。
- `display=swap` 必须显式加，否则文字可能长时间不可见。
- 只给拉丁子集时中文会回退到系统字体，需确认回退栈。

## 7. 受限环境可用性

| 环境 | 结论 | 说明 |
|---|---|---|
| 无构建 | 可用 | 一个 `<link>` 即可 |
| ESM / 打包器 | 可用 | 但自托管更可控 |
| SSR | 可用 | 纯 CSS 引用 |
| 离线 / 内网 | 不可用 | 需下载字体自托管 |

## 8. 稳定性评分

| 维度 | 评分 | 依据 |
|---|---|---|
| 维护活跃度 | 5 | Google 长期维护 |
| 版本与破坏性变更 | 4 | v2 API 稳定 |
| 采用度 | 5 | 使用面极广 |
| 体积与按需 | 4 | 可控，但易被滥用 |
| 生态兼容 | 5 | 纯 CSS，无依赖 |
| License | 5 | 字体多为 OFL / Apache-2.0 |

## 9. 替代品对比

| 方案 | 优势 | 劣势 | 何时选它 |
|---|---|---|---|
| Fontsource | npm 自托管、版本锁定、无第三方请求 | 需要构建或手动拷文件 | 生产项目 |
| Bunny Fonts | 与 Google Fonts API 兼容、强调隐私 | 字体数量少于 Google | 欧盟合规 |
| Fontshare | 免费商用字体、质量高 | 库小 | 品牌站 |
| 系统字体栈 | 零请求、零体积 | 视觉不可控 | 内容型站点 |

## 10. 自托管建议

```bash
npm i @fontsource-variable/inter
```

```js
import '@fontsource-variable/inter';
```

自托管后记得配 `font-display: swap` 与 `preload`，并按 `unicode-range` 做切片。
