Commands you will use
本页面是 Faber 入门第一周的实用 CLI 速查表。可将其用作命令索引;当需要了解具体标志和编译器流水线细节时,请打开详细的 Faber 构建工具页面。
每日循环#
| 命令 | 用途 |
|---|---|
faber check <package> | 快速前端校验:词法分析、解析、类型检查、降阶 |
faber build <package> -t rust | 生成 Rust 项目以供审阅或原生编译 |
faber run <package> | 构建并执行应用程序包 |
faber test <package> | 当包定义了测试入口时运行包测试 |
faber explain <code> | 读取稳定的诊断说明 |
请从 check 开始。它是最轻量的命令,也是代理在将生成的代码作为有效 Faber 提交之前应当运行的命令。
检查#
faber check .
faber check examples/ai-workbench/packages/faber-ai通过 check 意味着该包在语法和语义上被编译器前端所接受。这并不代表最终的原生工具链已被调用。
构建#
faber build . -t rustRust 目标的设计初衷是便于审阅。生成的 Rust 是编译器产物,而非事实来源;请编辑 Faber 包并重新构建,而不要手动修补已生成的 Rust。
运行#
faber run .对带有 入口 入口点的应用程序包请使用 run。仅作为库的包应当通过 check 和 test 进行验证。
解读诊断#
faber explain SEM001
faber explain LEX006诊断族是稳定的句柄:LEX 表示词法错误,PAR 表示解析器错误,SEM 表示语义/类型错误。在文档和代理报告中,请引用诊断代码,而不要含糊地转述编译器失败信息。
读取器区域命令#
faber format --reader-locale=la path/to/file.fab
faber format --reader-locale=th-TH path/to/file.fab
faber emit -t faber --reader-locale=zh-Hans path/to/file.fab读取器区域输出是对编译器语义模型的渲染,而非浏览器运行时的翻译层。区域化工作应当在包以规范形式通过 check 之后进行。