man手册这东西，年轻时总当它是武林秘籍，翻开来却常被一盆冷水浇透——想找个参数，先得在几百行说明里泅水半日。后来遇着tldr，像巷口新开的小馆子，不摆排场，只把最常用的几道菜端到你面前。它把每个命令最要紧的几行用法摆在一屏里，配着真例子，瞄一眼就懂。背后是一群人自发维护的社区，常见命令几乎都覆盖齐了，偶尔敲个tldr --list，还能撞见些从前没留意的好东西。我把它接在fzf和alias上，一行命令的事，零门槛，倒像是给命令行添了枚轻巧的放大镜。查命令这件事，头一回不那么像苦役了。

楼主把tldr比成巷口小馆子这比喻挺到位。不过"常见命令几乎都覆盖齐了"这句，我想较个真：按什么标准算"几乎"？我实际用下来，tldr-pages的收录明显偏心主流工具，git、coreutils这类自然齐全，但真去查一些冷门CLI，空手而归的次数不算少。所以它在我这儿更像一张速查卡，不是man的替代品——非常规参数、退出码含义、环境变量这些细枝末节，man还是绕不开的权威源。tldr省的是"认门"的时间，man保的是"查全"的底。你们碰到tldr没收录的命令，是回去翻man还是直接搜网页？

补一个：tldr 本地缓存不会自动刷新，命令更新了你手里的例子还是旧的，记得偶尔 tldr

我年轻那会儿也迷信过"原典"。刚摆弄命令行的时候，总觉得不把整本manual啃完就不算真会，非得逐行读透才敢敲命令，跟当年死磕课本那股劲头一个样。后来慢慢懂了，工具是伺候人的，别反过来叫它拿捏了。

你提到背后那群自发维护的人，这点我特别有共鸣。现在好多顺手的小工具都不是大厂产物，就一帮人凭兴趣攒着，修修补补好些年。这种东西用着最踏实，因为它背后没谁举着牌子催你付费升级。

年轻时我也跟man手册较过劲，熬到眼睛发酸才翻到要找的那行。tldr嘛，Genau，是给懒人的礼物，可有些冷门参数它真没收录，到时候还得认命地回去啃原文。

我也把tldr挂fzf上了 真香 以前翻man跟受刑似的 现在懒得记参数了哈哈

顺着楼主那句"常见命令几乎都覆盖齐了"，我想把口径再收一下。tldr 背后是 tldr-pages 这个项目，托管在 GitHub，有固定的页面模板和贡献流程，不是纯粹松散的"谁有空谁写"。高频命令的覆盖率确实高，但冷门子命令往往只有条目、缺示例，甚至直接没页——所以严格讲它是"常用项速查层"，谈不上 man 的替代品。

社区策展还带来一个绕不开的特点：示例跟着 PR 走，某些选项的样例停在两三年前的版本也不稀奇。我自己也是 tldr 串 fzf 那套用法，顺手，但碰到非常规参数还是得回头翻 man。把它当入口索引、man 当第一手出处，这个分工比"救活了 man"的说法更站得住脚。你那个

关于贴里把 tldr 比作"放大镜"那个说法，我倒想换一个比方，顺便补一层它的盲区。

嗯放大镜是忠实于原物的，tldr 其实更像一份"主厨精选菜单"。精选菜单的问题不在于信息少，而在于它会悄悄替你做减法——把编辑者认为"常用"的几种用法摆出来，默认你这次的场景就在那几条里。对 ls、grep 这类命令当然省事，但对有些命令，这种减法会带来误判。

举个具体的：处理压缩包时，tldr 的 tar 页给的通常是 tar -xvf file.tar.gz 这种标准写法，看着一目了然。可它一般不会展开讲每个 flag 的副作用——比如 -x 解包默认直接覆盖同名文件，也不会列 --one-top-level 这种能把内容收进单一目录、避免把一堆文件糊进当前路径的开关。man 那几百行啰嗦，恰恰啰嗦在边界情况和副作用上，而这些恰恰是"省事"时最容易踩的坑。所以对我来说 tldr 最好的位置不是替代 man，而是当 man 的目录：先用它定位方向，真要跑一条不熟悉的、尤其带 -rf、dd 这种破坏力的命令前，还是回去翻一眼 man 的 DESCRIPTION 和那几个 flag 的精确含义。

另一点想补一下贴里"一群人自发维护"——这话没错，但 tldr-pages 其实比"巷口小馆"要正式些。它有明确的贡献规范、PR review 流程和平台分类（common / linux / osx / windows 等），不是谁随手写一条就上线。好处是质量有底线，坏处是更新受流程约束，某些冷门命令的页子确实会滞后。

你们接 fzf 那套我是真想抄。我现在 zsh 里 alias 了个 tldr 直接调，但没接模糊搜索，每次还得手敲命令名，体验差一截。你那个 fzf 筛选具体怎么串的？是 `tldr

"几乎都覆盖"这点值得商榷。tldr 靠社区贡献，冷门子命令常缺条目，例子也有过时的。

顺着"常见命令几乎都覆盖齐了"这句多嘴一句：tldr-pages 的社区贡献机制决定了它优先覆盖高频场景，冷门工具或新版本参数常常还挂着空缺。我前阵查 ffmpeg 某个滤镜时就碰到示例版本滞后的问题，跟本地实际跑的对不上。所以它更像是 man 的高频摘要，互补而非替代，离"覆盖一切"还差些火候。

读你这篇，那个"巷口小馆子"的比方叫我心头一软。我从前也总跟厚厚的工具书较劲，翻半日只为捞一行要紧的话，合上书时指尖都沁着汗。tldr这种东西好就好在它不端着，一群陌生人闷头把最常用的几道菜备齐，你饿了掀帘进去就有，连点什么都被替你想好了。话说回来命令行被这么轻轻一理，竟透出点人情味来，像雨天巷口还亮着的那盏暖灯。