https://suchaharcan.github.io/ 月更 技术博客 CXX优先 Zola en Sun, 11 Oct 2026 00:00:00 +0000 Sun, 11 Oct 2026 00:00:00 +0000 Suchaharcan https://suchaharcan.github.io/03Share_blog/tealdeer-mac-config/ https://suchaharcan.github.io/03Share_blog/tealdeer-mac-config/ <h1 id="tldr">TLDR</h1> <blockquote> <p>Tealdeer 是Rust版的TLDR工具； 个人感觉 比tldr(tlrc) 更好用； 但 文档 不清晰，现有教程落后，补充当前可用操作；</p> </blockquote> <h2 id="an-zhuang-he-tong-yong-pei-zhi-ming-ling">安装和通用配置命令</h2> <pre class="giallo z-l-code z-d-code" ><code data-lang="shellscript"><span class="giallo-l"><span class="z-l-2 z-d-5">brew</span><span class="z-l-8 z-d-10"> install</span><span class="z-l-8 z-d-10"> tealdeer</span><span class="z-l-6 z-l-i z-d-2 z-d-i"> #</span><span class="z-l-6 z-l-i z-d-2 z-d-i">通过Homebrew 安装tealdeer</span></span> <span class="giallo-l"><span class="z-l-2 z-d-5">tldr</span><span> -</span><span>-seed-config</span><span class="z-l-6 z-l-i z-d-2 z-d-i"> #</span><span class="z-l-6 z-l-i z-d-2 z-d-i"> 创建默认配置 必须要操作</span></span></code></pre> <blockquote> <p>https://docs.tealdeer.org/stable/ 简单查看配置中 节点说明 默认配置中会直接设置在线文档的URL，既往搜索记录均是错误 这是一个踩坑点 <br/> 默认配置中手动指定语言，与tlrc和既往版本不一致 <br/> 若 仓库已经安装过tldr 或 tlrc ,必须先 brew unlink tldr/tlrc</p> </blockquote> <h2 id="chang-jian-ming-ling">常见命令</h2> <pre class="giallo z-l-code z-d-code" ><code data-lang="shellscript"><span class="giallo-l"><span class="z-l-2 z-d-5">tldr</span><span> -</span><span>-show-paths</span></span> <span class="giallo-l"><span class="z-l-2 z-d-5">tldr</span><span class="z-l-8 z-d-10"> git</span><span> -</span><span>-edit-page</span><span class="z-l-6 z-l-i z-d-2 z-d-i"> #</span><span class="z-l-6 z-l-i z-d-2 z-d-i"> 修改自定义页面</span></span> <span class="giallo-l"><span class="z-l-2 z-d-5">tldr</span><span class="z-l-8 z-d-10"> git</span><span> -</span><span>-edit-patch</span><span class="z-l-6 z-l-i z-d-2 z-d-i"> #</span><span class="z-l-6 z-l-i z-d-2 z-d-i"> 修改 自定义补丁页面</span></span></code></pre><h2 id="chang-jian-chang-jing">常见场景：</h2> <ol> <li>上游现有页面</li> <li>自定义页面（覆盖同名1） <command>.page.md</li> <li>扩展现有页面 (追加 1 ) <command>.patch.md 警告 ，扩展不对 自定义页面服务</li> </ol> <blockquote> <p>后期 定期 将 自定义路径中 扩展页面上传到仓库中归档保存备份</p> </blockquote> <h1 id="wei-he-yao-yong-tldr">为何要用TLDR ?</h1> <p>tldr 在日常开发和系统管理工作中扮演着重要的角色，极大地提升了效率：</p> <p>优点：</p> <ul> <li> <p>尊重时间： 用户普遍认为 tldr 在最短时间内提供了最直接、可操作的命令示例，极大地提升了日常工作效率。</p> </li> <li> <p>极高的易用性和记忆效率： 简洁的格式不仅易于快速消化，也更容易被用户记住。</p> </li> <li> <p>社区驱动的活力： 开放的贡献模式使得内容能够持续更新和完善。</p> </li> <li> <p>灵活的跨平台支持： 多样化的客户端满足了不同用户和环境的需求。 缺点与权衡：</p> </li> <li> <p>深度和全面性不足： 这是最常被提及的缺点。tldr 为了简洁而牺牲了全面性，对于不常见的用例或需要理解命令底层工作原理的场景，用户仍需回归 man 页面。</p> </li> <li> <p>覆盖范围有限： 对于一些较新、较小众或特定领域的命令行工具，可能不存在对应的 tldr 页面。</p> </li> <li> <p>示例可能过于简化： 在某些情况下，tldr 提供的示例可能无法满足中高级用户的复杂需求。</p> </li> <li> <p>潜在的依赖风险： 一些经验丰富的用户担忧，过度依赖 tldr 可能会让新手养成“只知其然，不知其所以然”的习惯，从而阻碍他们深入学习和理解 shell 命令及操作系统。</p> </li> </ul> <p><strong>以实例为中心</strong>： 这是 tldr 最受赞誉的特点。它不解释命令的每一个参数，而是直接展示 80% 最常见的用例。例如，对于 tar 或 ffmpeg 等拥有大量复杂参数的命令，tldr 直接提供“解压一个 .tar.gz 文件”或“从视频中提取音频”等具体示例，让用户能够快速上手。 <code>比手册man更快</code> <br/> <strong>简洁易读的格式</strong>： tldr 的信息结构简洁明了，通常只包含几行文字和几个代码示例。输出通常带有语法高亮，格式清晰统一，非常适合快速扫读和复制粘贴。<br/></p> <p><strong>离线访问能力</strong>： 大多数 tldr 客户端在首次运行时会下载并缓存所有页面到本地。这意味着一旦页面被缓存，即使在没有网络连接的环境下，用户也能快速查询命令用法，确保了工作流的连续性</p> <p><strong>自定义页面/补丁扩展页面</strong>: 解决在线文档没有覆盖但个人需要的部分</p>