// 红队渗透 · 2024-12-25

告别繁琐文档！3步教你用 TLDR 快速掌握终端命令，小白的救星！

linux

TL;DR（Too Long; Didn’t Read）是一款超级实用的终端命令简明手册工具。它提供社区维护的常用命令示例，帮助你快速掌握用法，避免翻阅冗长的 man 手册，让终端操作更高效、更流畅！🚀

此外，还有一个现代化实现版本 —— tealdeer，用 Rust 编写，速度更快、缓存更智能、功能更丰富，是目前许多开发者首选的 tldr 客户端。强烈推荐尝试！

为什么选择 TL;DR（或 tealdeer）？🤔

  1. 简洁实用：只展示最常见的用法示例，直击痛点，无需阅读长篇文档。🔥
  2. 多语言支持：包括中文页面，让母语用户操作更舒适（部分命令已有完整翻译）。🇨🇳
  3. 离线优先：本地缓存页面，查询瞬间完成，无需依赖网络。📴
  4. 社区驱动：示例由全球开发者贡献，不断更新，覆盖海量命令。
  5. tealdeer 额外优势：启动极快、自动更新、智能分页、彩色高亮，体验更现代！⚡

安装方法 ⚙️

推荐：安装 tealdeer（现代化 Rust 版本）

tealdeer 是最受欢迎的 tldr 实现，命令同样为 tldr。

  • macOS（使用 Homebrew）：

    brew install tealdeer

  • Linux（多种方式）：

    • Debian/Ubuntu： 
      sudo apt update
sudo apt install tealdeer
    • Fedora： 
      sudo dnf install tealdeer
    • Arch Linux： 
      yay -S tealdeer
    • 使用 Cargo（需先安装 Rust）： 
      cargo install tealdeer

传统 tldr 客户端安装

  • Debian/Ubuntu（apt）：

    sudo apt update
sudo apt install tldr

  • Node.js（npm）：

    npm install -g tldr

  • Python（pip）：

    pip3 install tldr

配置中文支持 🇨🇳

tldr-pages 项目支持多种语言，包括中文（zh）。

  • 传统 tldr 客户端：

    export TLDR_LANGUAGE="zh"

    添加到 ~/.bashrc 或 ~/.zshrc 中永久生效。

  • tealdeer： 支持自动检测系统语言，或手动指定：

    tldr -L zh tar  # 单次指定中文

    想永久设置，可在配置文件 ~/.config/tealdeer/config.toml 中添加：

    [display]
languages = ["zh", "en"]

更新缓存 🔄

首次使用或定期更新，确保页面最新：

  • 传统 tldr：

    tldr --update

  • tealdeer（推荐自动更新）：

    tldr --update

    tealdeer 默认智能缓存，查询更快。初次运行会自动下载页面。

基本使用 🎯

查询命令示例非常简单：

tldr tar    # 查询 tar 命令
tldr git checkout   # 支持子命令
tldr -l     # 列出所有缓存命令（tealdeer 支持）

示例（已配置中文）： 命令示例截图

如果某些命令无中文翻译，会自动回退英文： 在这里插入图片描述

tealdeer 还支持彩色输出、分页显示（自动调用 pager），体验更佳！

注意事项 ⚠️

  • 中文页面覆盖率在不断提升，但部分命令仍以英文为主。
  • tealdeer 与传统 tldr 使用相同页面源，兼容性极好。
  • 如需更多自定义（如颜色、自动更新），查看 tealdeer 文档：https://github.com/tealdeer-rs/tealdeer

总结 🏁

无论是经典 tldr 还是现代化 tealdeer，都能大幅提升你的终端效率。尤其推荐 tealdeer —— 更快、更智能、更现代！赶紧安装试试，让命令行操作从此轻松自如～🎉

原文 https://blog.csdn.net/2301_79518550/article/details/144720456