工具链
cli-tools-error-handling
更新于 2026-10-01
CLI Tooling · 错误处理规则
Error-handling rules for CLI Tooling: classification, typed codes and single-point mapping to user outcomes.
- 技术栈
- CLI Tooling
- 主题
- 错误处理
- 条目
- 9 条
- 版本
- v0.2.0
✓ 应当这么做
- ✓ Classify failures once: expected (validation, not-found) vs unexpected (bugs, dependencies down)
- ✓ Return typed errors carrying a stable code plus human-readable context
- ✓ Map errors to user-visible outcomes at the outermost layer only
✕ 常见反模式
- ✕ String matching on error messages to decide control flow
- ✕ Swallowing an error to keep the happy path green
- ✕ Leaking stack traces or internal identifiers to end users
◎ 交付前验证
- ◎ Dry-run output reviewed before a real execution
- ◎ Tool version pinned and behaviour re-validated after upgrades
- ◎ Failure path returns a clear diagnostic