命令行界面设计指南
来源:clig.dev — 2026-07-16
📋 概述
CLIG(Command Line Interface Guidelines)是由 Docker Compose 的联合创作者 Aanand Prasad 和 Ben Firshman 等人发起的开源指南,旨在将传统 UNIX 哲学与现代用户体验设计原则融合。这份指南系统性地覆盖了 CLI 设计的方方面面——从帮助信息、错误处理到交互模式和命名规范,强调"以人为本"的设计理念,认为命令行工具应该像对话一样自然流畅。
🔑 核心要点
- 指南提出了 CLI 设计的九大哲学原则:以人为本、简单协作、一致性、说够就行、易于发现、对话为本、健壮性、同理心和拥抱混沌
- 核心观点:CLI 应该是用户与机器之间的对话,而不是用户向机器下达命令的单向指令
- 在输出设计上,指南强调机器可读与人类可读的平衡,建议默认输出为人类优化,同时提供 --json 等机器友好选项
- 错误信息应该告诉用户如何修复,而不仅仅是指出什么出错了——这与现代 API 设计的"可操作错误"理念一致
- 指南由 Docker Compose、Replicate、Smallstep 等知名工具的作者编写,融入了大规模生产环境中的实战经验
💡 金句
The command line is still the most versatile corner of the computer — it lets you pull back the curtain and creatively interact with the machine at a level of sophistication that GUIs cannot afford.
← 返回 Hacker News 首页