展开本页目录
开始前准备什么
- Node.js与npm已可运行；练习只需本地文本文件和官方@google/design.md CLI，不需要Stitch账号或付费生成。
- 固定当前CLI版本并保留版本号；DESIGN.md仍为alpha格式，升级前先在练习副本复核。
- 本课给出作者自制规则文件和预期，不把预期JSON冒充已执行的官方CLI返回。
- 写出有意和无意两类缺项
- 查看当前alpha规范
- 只标记有理由的省略
- 运行并读取不同finding
- 补回必要的字体规范
- 检查多余与拼错的省略项
- 交付取舍与完整性说明
1. 写出有意和无意两类缺项
准备一个无阴影的预约面板，注明它刻意保持平面层次。
同时故意漏写正文typography，让两个问题在同一练习中可被区别。
2. 查看当前alpha规范
使用designmd spec --rules查看已安装版本的omitted结构与规则，同时保存版本。
不要从旧博客复制可能过期的字段形状，本课以实际规范为准。
3. 只标记有理由的省略
按当前规范在omitted中说明不使用rounded；无阴影取舍写入Elevation的用途说明。
正文仍需要排版数据，不能把漏字体也声明为“故意省略”来压掉提示。
官方界面与功能位置
以下为官方文档配图，具体版本与账号入口以当前产品为准。本课练习输入与验收对照见相邻步骤。
4. 运行并读取不同finding
lint后记录当前版本实际规则：本课0.4.0出现declared-omission、unknown-omission、missing-typography等；main规则名不等于已发布版全部相同。
info、warning和error分开列，不能用总条数减少就判设计更完整。
5. 补回必要的字体规范
加入body-md字体与行高，保留无阴影决定。
不需要的章节不填空值，避免产生一份表面齐全但无法消费的文件。
6. 检查多余与拼错的省略项
在负例中加入一个当前规范不识别的omitted名称，观察真实反馈。
只记录当前版本实际行为，不把未知名称默默接受当跨版本保证。
7. 交付取舍与完整性说明
保存正确omitted、负例、字体补全记录以及平面界面预览。
列出还需由页面实现的层次线索，例如间距和边框，而不是仅写“不用阴影”。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- 故意省略的项有明确用途理由。
- 必需字体被补全，未以omitted掩盖缺项。
- 当前spec、CLI版本和实际finding一起保存。
常见问题
DESIGN.md少一个章节就一定不完整吗？
先列明刻意不用阴影与意外缺字体两种情况，用已安装版本的 spec --rules 确认 omitted 结构，再只登记有理由的省略。读取相关 finding 并检查导出，不用空章节掩盖缺项。
为了让lint没提示，把缺的项全加到omitted可以吗？
不应这么做。这样可能只改变报告而没有形成可用设计；本课逐项记录理由，并保留缺字体的负例证明必要信息仍要补。