参考
指南讲的是如何构建并交付一份捆绑包。本章是查阅用的那一半:确切的标志、确切的字段名、确切的默认值, 以及框架拒绝跨越的那些边界。
这里不重复任何教程。凡是指南中已经解释过的概念——配置模型、七个钩子事件、证明级别——本章只链接过去, 并仅记录契约本身。
如何读诊断
每条命令报告的都是结构化诊断,而不是散文式错误。一条诊断包含稳定的 AB 代码、一个严重级别、一条消息,
通常还有 sourcePath 与一条 recovery 提示。对于由诊断把关的命令——build、prepack、validate、
doctor、install 与 dev——只有 error 级别才会让命令以非零退出;warning 与 info
绝不会为构建、校验或 dev 重建把关。eval 与 inspect 还有一个与诊断无关的以 1 退出的理由:
失败或无定论的试验,或者无效的模型——见命令行退出码。
完整的代码目录见诊断参考,它在构建时由仓库中的
docs/diagnostics.md
渲染而来。