如何安装 tldr pages：更新缓存、阅读简化命令示例与 man 页对照

安装 tldr，更新缓存，查命令示例，并知道何时仍用 man。

记不全 tar、ffmpeg 或 docker 的长选项时，man 页信息全但难扫；tldr pages 社区维护精简示例，客户端命令通常是 tldr。本教程覆盖 macOS/Linux/Windows 安装 tldr、用 tldr --update 更新本地缓存、查命令示例，以及与 man/--help 的对照，面向 hereink 读者常用的终端工作流。

检索词是如何安装 tldr pages 并更新缓存查看命令示例。读完应能安装 tldr、刷新页面库、用 tldr git 这类命令读到可复制示例，并知道何时仍该打开 man。

tldr 解决什么问题

页面库：github.com/tldr-pages/tldr，站点 tldr.sh。常见 Rust 客户端 tealdeer（二进制名 tldr）；另有 Node、Python 客户端，命令名同为 tldr。

安装 tldr 客户端

1. 1
   macOS（Homebrew，tealdeer）

   brew install tealdeer。验证：which tldr 与 tldr --version。Homebrew 也可能提供独立的 tldr formula，二者择一即可，避免 PATH 里两个同名命令冲突。

2. 2
   Linux

   Arch：pacman -S tealdeer。Debian/Ubuntu 可从发行版包或 cargo install tealdeer 安装。Fedora 等见 tldr.sh 的 Clients 列表。通用：npm install -g tldr（Node 客户端）。

3. 3
   Windows

   scoop install tealdeer 或 choco install tealdeer；也可用 npm install -g tldr。新开终端后 tldr --version。

4. 4
   首次拉取页面

   多数客户端首次查询会自动下载缓存；也可手动 tldr --update（见下一节）。需要代理时按客户端文档设置 HTTP_PROXY 等。

用 tldr --update 更新缓存

社区页面每日合并 PR；本地缓存会过期。定期更新：

# 从 tldr-pages 仓库同步最新页面（各客户端命令相同）
tldr --update

# 查看缓存位置（tealdeer 示例）
tldr --list
tldr --info

更新失败时检查网络、磁盘权限与 GitHub 可达性。公司代理环境需配置系统或环境变量代理；勿从不明来源下载第三方页面包。

阅读简化命令示例

# 基本查询
tldr tar
tldr git commit

# 指定平台（Linux / osx / windows 页面略有不同）
tldr --platform linux curl

# 列出已缓存的命令
tldr --list | head

# 搜索相关页（部分客户端支持）
tldr -s archive

输出结构通常是：一行描述 + 若干「示例说明 + 命令行」。直接复制到终端前，先读注释里的占位符（如 path/to/file、host），避免误删生产数据。

tldr 与 man / --help 对照

适合

忘 flags、写 README 示例、SSH 到陌生服务器快速回忆命令、与 gh、jq 教程里的工具并列使用。

不适合

安全敏感参数（chmod、iptables）、需要精确语义的法律/合规场景——必须读官方 man 或文档再执行。