核心用法
tldr 是「Too Long; Didn't Read」的缩写,提供社区维护的简化版命令行工具手册。与标准 man 页不同,它聚焦常用场景 + 具体示例,剔除罕见参数和冗长说明。
主要功能:
tldr <command>— 查看某命令的精简示例(如tldr tar)tldr --update— 更新本地缓存tldr --list— 列出当前平台所有可用页面
显著优点
1. 极致精简:平均 5-10 行示例 vs man 页的数百行,token 消耗极低
2. 场景导向:直接给出「压缩文件」「解压到目录」等实用场景,而非参数罗列
3. 跨平台一致:Linux/macOS/Windows 均可使用,社区持续维护
4. 离线可用:缓存到本地后无需联网
潜在局限
- 覆盖不全:小众工具或最新版本命令可能缺失
- 深度不足:复杂用法、边缘场景需回查
man或--help - 社区依赖:示例质量参差不齐,偶有错误
适合人群
- 快速上手新 CLI 工具的新手
- 记不住参数、只需常见用法的日常用户
- AI 助手(token 效率优先的场景)
常规风险
- 缓存版本滞后于官方文档,关键操作建议二次确认
- 无权限隔离,需信任 tldr-pages 社区内容
> 建议策略:优先查 tldr,缺失时再 man/--help 补全。