开始使用
日常工作流
用检查、格式化、测试、运行和构建形成可重复的项目反馈循环。
在项目根目录保持这一顺序：
yanbao check
yanxu fmt --write src
yanbao test
yanbao audit
yanbao run
yanbao build --release| 阶段 | 目的 | 适合何时运行 |
|---|---|---|
check | 发现词法、语法、类型、模块与清单问题 | 每次编辑后 |
fmt --write | 写回稳定、幂等的规范格式 | 提交前或保存时 |
test | 执行目录规格并比较期望输出 | 改动行为后 |
audit | 复核锁图、来源、许可证、漏洞、目标与原生制品 | 依赖变化后及发布前 |
run | 通过项目入口与声明权限运行 | 本地验证完整流程 |
build --release | 生成优化的 YXB 或目标制品 | 发布候选阶段 |
依赖变化后先运行yanbao install，并把言序.toml与言序.lock一起提交。不要手工修改锁文件；需要理解某个包为何出现时，使用yanbao tree与yanbao why 包名。
CI 至少应执行检查、格式化一致性、规格测试、依赖审计和构建。需要机器消费时使用言包的 JSON 或 JSON Lines 输出，并保留非零退出状态。编辑器诊断用于缩短反馈时间，但不能代替这些可重复命令。命令全集见CLI 参考，项目边界见项目工程。