---
name: 字体体系跨平台调整经验
description: 设计文档使用平台专有字体（SF Pro）导致跨平台不可用的经验教训
type: feedback
originSessionId: db0433d0-22b3-4676-8741-4963be58cb24
---
## 经验教训：设计文档字体选择必须考虑目标平台可用性

**问题**: 设计文档指定 SF Pro Display/Text 作为排版字体，但 SF Pro 是 Apple 专有字体，在 Ubuntu 24.04 上不可用且不支持中文。

**Why**: 设计时过度参考 Apple 设计规范，未验证字体在目标平台（Linux）上的可用性。SF Pro 既不能合法安装在 Linux 上，也不含 CJK 字形。

**How to apply**:
1. 设计文档中的字体、色彩、组件等设计令牌必须在目标平台上**可实际获取**
2. 涉及 CJK 内容时，必须显式指定中文字体（如 Noto Sans SC）
3. Dockerfile/Docker 配置中需要安装对应的字体包
4. 设计变更影响多个文档时，按设计令牌层→界面规格层→交互层逐级同步更新
5. 新项目初始化时就应确定字体体系，避免后期大规模替换

**替换方案**: Inter Display/Inter + Noto Sans SC + JetBrains Mono
- Inter: SF Pro 最佳开源替代品，x-height 和字重分布一致
- fonts-inter 包自带 Inter Display 变体，支持光学尺寸（≥20px 用 Display，<20px 用 Inter）
- Noto Sans SC: Google 出品 CJK 字体，Ubuntu 24.04 通过 fonts-noto-cjk 安装
- JetBrains Mono: 等宽字体，密码/代码/ID 字段使用

**变更范围**: 15 个文件（1 Dockerfile + 1 CSS + 9 设计文档 + 2 spec/plan + 2 member 日志）