在日常开发与运维过程中，你是否会觉得传统的 man 手册过于繁琐？tldr 项目正是为了解决这个问题而生，它为上百个常用命令提供了简明直观的示例，极大地提升了查阅效率。本文将手把手介绍 tldr 在 Windows、Mac、Ubuntu 下的安装流程，基本使用方法，以及如何让 tldr 输出为简体中文。
一、tldr 安装方法1. Windows 系统方法一：用 Scoop 安装（推荐）
安装 Scoop（如果还没装）：
12Set-ExecutionPolicy RemoteSigned -Scope CurrentUserirm get.scoop.sh | iex
安装 tldr：
1scoop install tldr
方法二：用 npm 安装需先装好 Node.js 与 npm，然后在命令行执行：
1npm install -g tldr
方法三：用 pip 安装需先装好python与pip，然后在命令行执行：
1pip3 install tldr
2. macOS 系统推荐使用 Homebrew：
1brew install tldr
或者用 npm：
1npm install -g tldr
或者用 pip：
1pip3 install tldr
3. Ubuntu / Debian 系统推荐方式（snap 安装）：
1sudo snap install tldr
或者用 apt（部分老版本仓库没有）：
12sudo apt updatesudo apt install tldr
还可以用 npm：
1npm install -g tldr
或者用 pip：
1pip3 install tldr
二、tldr 的基本使用安装好 tldr 后，在命令行中直接输入：
1tldr 命令名
例如：
1tldr tar
它会显示 tar 常用的简要用法和示例。
常用选项：
tldr -u强制更新离线文档缓存。
tldr --list查看有哪些命令有 tldr 页面。
tldr --help查看 tldr 的详细帮助信息。
三、配置 tldr 显示中文页面tldr 官方已支持多语言，目前大部分主流命令已有简体中文文档。只需调整默认语言环境变量即可。
1. 临时使用中文只对当前命令生效：
1LANG=zh tldr ls
或（部分 tldr 客户端支持）
1LANGUAGE=zh tldr ls
2. 永久设置为中文macOS / Ubuntu / WSL将下方内容添加到 ~/.bashrc 或 ~/.zshrc（具体看你用哪个 shell）：
1export LANG=zh
保存后，执行一次：
1source ~/.bashrc # 或 source ~/.zshrc
这样每次开新终端，tldr 默认输出中文页面。
Windows（CMD 或 PowerShell）CMD 中临时生效：
12set LANG=zhtldr ls
长期生效：在系统环境变量或用户环境变量中添加 LANG，值填 zh。
3. 更新缓存（非常重要）修改语言后，强烈建议刷新缓存让中文页面生效：
1tldr -u
4. 验证效果运行：
1tldr cp
如果出现中文简明用法，表明配置成功。
四、常见问题
部分命令还是英文？可能该命令尚未有中文翻译。同样建议及时更新缓存。
未知命令提示或无法联网？检查网络或采用 tldr --update 手动补全离线缓存。
Windows 环境变量生效问题？尝试重启终端或电脑，确认语言变量设置无误。
五、总结tldr 是极简而实用的命令行速查工具，无论软件开发者还是 Linux/Unix/Windows 运维者都能从中获益。通过简单的安装和配置，你就能轻松查阅常见命令的简明用法，还能设为汉语输出，降低理解难度，为高效开发助力。
扩展阅读：
官方网站：https://tldr.sh/
GitHub 项目：https://github.com/tldr-pages/tldr