Good CLI Design Is Mostly Silence
18 hours ago
- 一个好的CLI知道何时保持沉默；输出是界面，而不是装饰。
- --quiet标志应意味着成功时不打印任何内容，除非有重要信息；而不仅仅是减少消息。
- stdout用于数据/结果；stderr用于日志、警告和诊断信息。切勿混用。
- 颜色输出必须通过--color=auto/always/never控制，默认值为auto（仅当stdout是终端时才显示颜色）。
- 退出码是API的一部分，应具有意义（例如，0表示成功，1表示发现差异，2表示失败）。
- 人类可读输出和机器可读输出（JSON）应分开；JSON是一个不应更改的约定。
- 后续命令的提示应简短且可选；它们不应出现在静默模式、JSON输出或stdout包含数据时。
- 沉默让用户重获控制权，建立对工具的信任。