欢迎回来
登录你的知识库账户
忘记密码?
还没有账户?立即注册
创建账户
注册你的专属知识库
已有账户?去登录
找回密码
输入注册邮箱获取验证码
返回登录
请输入图片中的验证码以继续注册
加载中...
取消
新建收藏
手动添加你喜欢的内容
取消
编辑头像与昵称
上传新头像或修改你的显示昵称
支持 JPG/PNG,最大 2MB
取消

问题反馈

notebasewww.notebase.cn
控制台
内容库
动态
管理
账户
U
用户
--
在线
v0.8.7 · 知识库
笔记
KnowledgeBase
网络无边,知识有迹。
0笔记
0工具
30推荐

分类导航

按主题直达

编辑精选

站内用户贡献 · 真实笔记

最新收录

每日更新
继续浏览全部内容 →
>
笔记
0
加载中...
工具
0
此页用于记录用户反馈问题后的每一次改进
笔记用法

“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。

md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。

要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。

工具用法

在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。

要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。

工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。

隐藏笔记

写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。

适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。

数据安全

你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。

技术

全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。

理念

这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。

原则

不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。

更多

产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。

举报

如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。

趋势
// 点击导航加载发现
归档
// 归档为空
最近浏览
// 暂无浏览记录
发布
// 加载中...
用户发布
// 加载中...
用户管理
// 加载中...
访问统计
// 加载中...
内容审核
// 加载中...
个人信息
// 加载中...
返回首页

tealdeer

tealdeer — 一个超快的 Rust 版 tldr 客户端,秒速帮你查命令用法,告别 man 手册的冗长折磨。

如果你跟我一样,是个天天泡在终端里的开发者,肯定有过这种经历:明明记得某个命令能干活,但具体参数是 -a 还是 -A,死活想不起来。这时候你大概率会 man xxx,然后面对一屏幕密密麻麻的英文文档,翻半天才找到想要的那一行——更别提有些 man 手册写得跟天书似的。

我之前试过 tldr(Too Long, Didn't Read),理念很好:把命令的常用场景和参数浓缩成几个简洁的示例。但官方的 Node.js 版启动有点慢,尤其我这种急性子,敲完命令到看到输出,那零点几秒的延迟都让我抓狂。直到我发现了 tealdeer——一个用 Rust 写的 tldr 客户端,快得离谱,几乎秒出结果。

它到底快在哪?

tealdeer 的核心优势就一个字:快。Rust 编译成原生二进制,没有 Node.js 的启动开销,没有 Python 的解释延迟。我自己实测,在同样网络缓存好的情况下,tealdeer 显示一个命令示例大概在 10-20 毫秒,而官方 tldr 客户端要 200-300 毫秒。如果你经常在终端里查命令,这个差距体感非常明显——就像从机械硬盘换到 NVMe 固态。

当然,快只是表象。它本质上是一个 tldr 客户端的实现,所以它能解决的核心问题是:让你用最少的阅读成本,快速掌握一个命令的常用用法。比如你想知道 tar 怎么解压 .tar.gz,不用去 man 手册里翻 -xzvf 到底哪个字母在前面,tealdeer 直接给你一个示例:

$ tar -xzf archive.tar.gz

干净利落。

下载与安装

tealdeer 的安装方式非常灵活,而且跨平台(Linux、macOS、Windows 全支持)。我推荐几种最省事的方法:

1. 包管理器安装(最推荐)

  • macOS (Homebrew):brew install tealdeer
  • Linux (各大发行版):
    • Arch Linux:pacman -S tealdeer
    • Fedora:dnf install tealdeer
    • Ubuntu/Debian:apt install tealdeer(注意:Ubuntu 官方源版本可能较旧,建议用下面 cargo 方式)
  • Windows (Scoop):scoop install tealdeer
  • Windows (Winget):winget install tealdeer

2. 从 GitHub Releases 下载二进制

如果你不想用包管理器,或者系统源里没有,可以直接去 tealdeer GitHub Releases 页面下载对应平台的二进制文件,解压后放到 PATH 里就行。比如 Linux x86_64 就下载 tealdeer-linux-x86_64-musl.tar.gz,这个版本用了 musl 静态编译,不依赖系统 glibc,兼容性极好。

3. 用 Cargo 编译安装(需要 Rust 环境)

如果你本身就是 Rust 开发者,或者想体验最新版:

cargo install tealdeer

这个方式会从源码编译,第一次稍微慢点,但后续更新也方便。

基础使用教程

装好之后,第一件事是更新缓存。tealdeer 默认会从 tldr 的官方仓库拉取命令页面,所以需要先执行:

tldr --update

这个命令会下载所有命令的缓存到本地,之后查询就完全是离线状态,快得飞起。

查询命令用法

最常用的就是直接 tldr <命令名>:

tldr tar

你会看到类似这样的输出(有颜色高亮,这里用文字示意):

tar

  归档实用工具,支持 tar、gzip、bzip2 等多种格式。
  更多信息:https://www.gnu.org/software/tar/manual/tar.html。

  - 创建一个归档文件:
    tar cf 目标.tar 文件1 文件2 ...

  - 解压一个 gzip 压缩的归档:
    tar xzf 源.tar.gz

  - 列出归档内容:
    tar tf 源.tar

每个命令的页面都包含几个典型场景,每个场景一行示例,注释清晰。比 man 手册不知道高到哪里去了。

搜索命令

如果你只记得命令名字的一部分,可以用 --search:

tldr --search zip

它会返回所有包含 "zip" 的命令,比如 zip、unzip、gzip 等。

查看所有命令列表

tldr --list

会列出当前缓存里所有可用的命令,数量取决于你之前更新的缓存版本,一般有几百个。

进阶技巧

1. 自定义缓存目录

默认缓存放在 ~/.cache/tealdeer 或 ~/.local/share/tealdeer,但你可以通过环境变量 TEALDEER_CACHE_DIR 修改:

export TEALDEER_CACHE_DIR="$HOME/.config/tealdeer/cache"

如果你想把缓存和配置统一管理,这个很实用。

2. 使用自定义页面源

tealdeer 默认从 tldr 官方仓库(GitHub 上的 tldr-pages)拉取数据。但如果你公司内部有自己的命令文档库,可以配置自定义源。编辑配置文件 ~/.config/tealdeer/config.toml(如果不存在就创建):

[display]
compact = false        # 默认 compact 模式,设为 false 会显示更详细的描述

[updates]
auto_update = true     # 查询时自动检查更新(默认 false,建议保持 false 手动更新)

3. 颜色主题与输出格式

tealdeer 支持 16 色和 256 色终端。如果你觉得默认颜色不好看,可以通过 --color 参数临时调整,或者设置环境变量:

export TLDR_COLOR=always   # always / auto / never

另外,如果你想输出纯文本(比如管道给 grep 或写入文件),加 --raw 参数:

tldr --raw tar | grep -i "gzip"

4. 结合 fzf 实现交互式查询

如果你经常记不清命令名字,可以把 tealdeer 和 fzf 结合起来,做成一个交互式命令浏览器:

tldr --list | fzf --preview 'tldr {}' --preview-window=right:70%

这样你会看到一个命令列表,选中后右边实时显示内容,非常爽。可以把这个 alias 加到 shell 配置里:

alias tldrf='tldr --list | fzf --preview "tldr {}" --preview-window=right:70%'

5. 在脚本中使用

tealdeer 支持 JSON 输出(通过 --json 参数),可以方便地被其他脚本解析:

tldr --json tar

输出是一个 JSON 数组,包含命令名称、描述、示例列表等字段,适合你用它来自动生成文档或集成到其他工具。

6. 离线模式

一旦你执行过 tldr --update,之后所有查询都是离线完成的。所以如果你在无网络环境(比如飞机上、内网服务器),只要提前更新过缓存,就能正常使用。这也是 tealdeer 相比在线文档的一个巨大优势。

一点个人感受

我用了 tealdeer 快两年了,从最初的好奇到现在的依赖,它已经成为我终端工具箱里不可或缺的一员。相比 man 手册的冗长,tldr 的示例驱动方式更符合现代开发者的习惯——我们不需要知道每个参数的哲学意义,只需要知道怎么用它完成工作。

而 tealdeer 作为 tldr 的 Rust 实现,把“快”这个体验做到了极致。每次 tldr curl 瞬间弹出示例,那种丝滑感,比打开浏览器搜索“curl 用法”快了不止一个数量级。

如果你还没试过,强烈建议装一个。哪怕你已经是 man 手册的忠实读者,偶尔换个口味,体验一下“秒查命令”的快感,也挺好的。

编写使用方法
Markdown 格式 · Ctrl+Enter 确定
新建笔记
预览
数据表格
点击单元格编辑 · Tab 移动
A1fx
Sheet1
BIH1H2≡🔗</>
隐私提醒

取消
编辑工具
取消