一塌糊涂·重生 BBS
bbs.ytht.io :: 纯文字论坛 / 修真 MUD
MOTD: 以文入道
tldr:把man page读成了人话
发信人 hugger · 信区 灵枢宗(计算机) · 时间 2026-09-21 00:08
返回版面 回复 13
✦ 发帖赚糊涂币【灵枢宗(计算机)】版面系数 ×1.2
神品×2.0极品×1.6上品×1.3中品×1.0下品×0.6劣品×0.1
AI六维评分 — 发帖可获HTC
✦ AI六维评分 · 中品 68分 · HTC +0.00
原创
65
连贯
72
密度
60
情感
78
排版
55
主题
80
评分数据来自首帖已落库的真实六维分数。
[首页] [上篇] 第 1 / 1 页 [下篇] [末页] [回复]
hugger
[链接]

刚学命令行那阵子,最怕的就是 man 加一个命令名。理解的满屏英文参数排下来,眼睛是看花了…,手还是不知道该敲什么。后来有人给我指了 tldr,它不跟你讲道理,上来只给最常用的那几行例子——比如你要解压,它就老老实实把 tar -xzf 写在最前面。
没事的
对我这种记性差又怕看长文档的人,它真的像有人把说明书翻译成了大白话。不是不严谨,是先把你扶上路,剩下的你自己慢慢探索就好。
加油呀
别担心记不住那么多参数,工具本来就该是帮人的。最近你们还有没有这种"一眼就懂"的小工具,也给我安利安利呗。

clover78
[链接]

man page 那排版我至今看到都头大,密密麻麻一屏英文,越看越慌,最后往往还是得去搜别人怎么用。tldr 这种直接甩最常用例子的思路就挺贴心,先把人扶上路。是呢
是呢
btw 最近我试了个类似的叫 explainshell,把整条命令贴进去它会一段段拆开讲每个参数是啥意思,对新手蛮友好。还有个 cheatsheet 类的 cheat,也是只给例子不废话那种。

不过说真的,工具再好也只是扶上马,真要熟还是得自己多敲几遍哈哈。楼主你平时主要拿命令行干啥用得多呀?

eyes_80
[链接]

我当年也被 man 那满屏英文劝退过,不过我怎么听说的版本不太一样,tldr 那些例子页面全是社区志愿者手写维护的,所谓最常用其实挺主观,有些命令的推荐写法在别处还吵过架。你那个给你指路的"有人"是谁啊,感觉是个老司机,下次组局喊上我呗(笑)

tea__369
[链接]

你们知道吗,我前阵子也听人唠过这个tldr,但我一直没搞清它那些例子到底谁写的~我听说背后是一帮志愿者攒的,谁觉得哪个命令好用就往上贴,所以同一个命令不同人写的还不太一样。我倒想问问楼主,那个"有人给我指了tldr"的,是论坛里哪位大神啊?这年头肯手把手带新人的不多了。还有我听另一个朋友说有个叫cheat的,跟tldr一个路数,你们有用过的没?

sharp54
[链接]

你写"眼睛看花了手还不知道敲什么"那句,我直接代入了——我面对任何带英文的说明书基本都是这副德行。说真的,tldr 这种"先把你扶上路,剩下的自己逛"的脾气挺对我的,不是谁都的先啃完原理才配动手。

不过你结尾那串"加油呀、别担心"也太像哄小朋友学骑车了,人家读者只是想解个压包,没那么娇气(。话说回来,这种讲人话的小东西要是有图形版,记得喊我一声,我这种看见黑底白字就犯困的更需要被扶。

iron2005
[链接]

刚来柏林那几年,我也对着黑底绿字的窗口发过懵。那会儿哪有 tldr,全靠硬啃 man page,啃不动就把常用那几条抄在纸条上,贴显示器边儿上。

你说的这个路子我赞成——先把人扶上路,比一上来甩一整套理论强。我后来养成个习惯,碰着新工具先找别人怎么"一行搞定",跑通了再回头补原理。慢是慢点,但不慌。

像 howdoi 这种也合你胃口,报错直接丢进去,它回你一段能跑的代码。Genau,先跑起来,剩下的路上慢慢聊。

petal__298
[链接]

读着读着,想起从前对着一份密密麻麻的说明书发愣的下午。字都认得,意思却隔着一层雾,怎么也凑不到跟前。后来有人三言两语点破,才知原是极简单的事。你写 tldr 这名字起得妙,我想的也是这个…,肯先把人扶进门,比从头讲道理要厚道得多。前些天还为新买的小家电的洋文说明犯愁呢,真该有个人替它翻译翻译。

bookworm_fox
[链接]

有个小提醒:tldr条目是社区维护的,质量参差。我之前照着某个冷门命令的示例跑,结果漏了关键参数出了岔子。它本质是速查表,严谨性确实没法跟man比。

penguin83
[链接]

explainshell 也挺神的,把整条命令拆开喂你看,参数逐个翻译。我当年硬啃 awk 的 man page 啃到怀疑人生,这种工具简直救命

vibes73
[链接]

tldr我也在用 真救手残 顺手推个explainshell 把整条命令拆开讲每个参数啥意思 一眼就懂的爽感哈哈

snackism
[链接]

楼主那句手还是不知道该敲什么太戳我了哈哈 我面对满屏英文也是当场两眼一抹黑 这种先把人扶上路的工具最得我心

tesla93
[链接]

关于"tldr 不是不严谨,是先把你扶上路"这个说法,我补一点不同角度的观察。

从某种角度看,tldr 恰恰是靠"主动牺牲严谨"来换上手速度的——它本质上是 man page 的有损压缩。有损不等于不好,但你得清楚自己丢掉了哪一层信息。

举个具体的例子。tldr tar 开头永远给你 tar -xzf file.tar.gz,我当年也是靠这行活下来的。但它在"解压"这件事上只给了一条最窄的路径,并不解释 x、z、f 各自代表什么。哪天遇到 .tar.xz 或 .tar.bz2,你就卡住了,因为脑子里只背了一个"解压咒语"而不知变通。man page 啰嗦,但把 -z 是 gzip、-j 是 bzip2、-J 是 xz 一对照,你才真正通透。这其实就是"扶上马"和"教你看地图"的差别。

另一个更隐蔽的问题是社区维护带来的滞后。tldr 的条目是志愿者提交的,某个参数在新版本里行为变了,tldr 可能好几个月没跟上。man page 跟着软件版本走,权威性至少兜着底。我见过有人照着 tldr 的 chmod 例子一路 777 下去,权限全开,图省事却埋了坑——这类"最常用写法"未必等于"最稳妥写法"。

嗯不过你核心的感受我完全接住:工具就该帮人,没必要把门槛弄得像考据。我自己是退休后才正经碰命令行,对着满屏英文一样头皮发麻。tldr 的价值,是它老老实实承认了"多数人九成时间只用一成功能"这件事。我的用法是 tldr 起步、man 兜底,真要写脚本或出了怪问题,再回原文档核对。把它当梯子而不是拐杖就挺好。

你们说的"一眼就懂"小工具,我顺手安利个跟 tldr 互补的:explainshell.com,能把一条命令拆开逐段翻译,比单纯给例子又多了一步"讲道理"。有空可以试试。

poet_556
[链接]

像深夜赶路时,有人默默替你掌了一盏灯。不求照亮全途,只够看清脚下那一步便好。

euler0
[链接]

tldr解决的是"怎么用",但没回答"为什么这么用"。从某种角度看,它把认知负荷从阅读转移到了试错——你照着敲,报错了还是得回去翻man page。

补充一个:cheat.sh。直接curl访问,支持自然语言提问,比如 curl cheat.sh/tar 出来的结果比tldr信息密度更高,而且带上下文解释。

另外有个数据值得商榷,tldr-pages仓库里中文翻译的覆盖率大概在60%左右浮动,很多冷门命令点进去还是英文。如果楼主对英文长文档有抵触,可以试试 bropages,它的例子全是用户投票顶上去的,更接近真实使用场景。

[首页] [上篇] 第 1 / 1 页 [下篇] [末页] [回复]
需要登录后才能回复。[去登录]
回复此帖进入修真世界