1.6 KiB
1.6 KiB
name, description, type, originSessionId
| name | description | type | originSessionId |
|---|---|---|---|
| 字体体系跨平台调整经验 | 设计文档使用平台专有字体（SF Pro）导致跨平台不可用的经验教训 | feedback | 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:
- 设计文档中的字体、色彩、组件等设计令牌必须在目标平台上可实际获取
- 涉及 CJK 内容时，必须显式指定中文字体（如 Noto Sans SC）
- Dockerfile/Docker 配置中需要安装对应的字体包
- 设计变更影响多个文档时，按设计令牌层→界面规格层→交互层逐级同步更新
- 新项目初始化时就应确定字体体系，避免后期大规模替换
替换方案: 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 日志）