核心用法
tldr(Too Long; Didn't Read)是社区维护的简化版命令行手册,将传统 man page 压缩为实用示例卡片。执行 tldr <command> 即可获取某命令最常用的 5-10 个场景示例,支持 tldr --update 同步最新社区内容。
显著优点
极致精简:相比传统 man page 动辄数千 token,tldr 单条命令通常仅需 100-300 token,大幅降低 LLM 上下文消耗;示例驱动:聚焦"最常见的 20% 用法解决 80% 问题",每个示例附带简短注释;跨平台覆盖:支持 Linux、macOS、Windows 及多种子命令组合;活跃社区:GitHub 超 5 万星,持续更新现代工具(如 docker、kubectl、gh 等)。
潜在局限
深度不足:复杂参数组合、边缘场景、安全警告可能被省略;版本滞后:社区贡献可能导致文档与软件最新版不同步;平台差异:部分命令的选项在不同 OS 上有细微差别,tldr 示例未必完全匹配当前环境;无交互探索:不支持类似 man 的搜索/跳转,需明确知道目标命令名称。
适合人群
CLI 新手快速建立命令直觉、需要频繁查询命令的开发者、LLM Agent 及自动化脚本(token 敏感场景)。
常规风险
内容依赖众包审核,偶见错误示例;--update 从远程拉取数据,需确保网络来源可信;不应替代官方文档处理生产环境关键操作。