文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载本文以 tldr 协作式命令速查表仓库中的pages.ar/common/pwd.md为核心结合英文参考页、仓库风格指南与相邻命令页面完整解读pwd命令的用法、-P/--physical选项背后的符号链接解析原理并演示如何在 tldr 页面体系中贡献多语言速查条目。读完本文你将能够准确区分逻辑路径与物理路径理解 tldr 占位符与选项占位符的书写规范并掌握一套可复现的命令排查与页面编写方法。引言一份速查页为什么值得逐行拆解tldr 项目以协作式控制台命令速查表为使命用极简的 Markdown 页面承载每个命令最常见的实战场景。pwd是其中最基础、也最具代表性的条目之一它只有短短几行却同时体现了 tldr 页面的排版规范、占位符语法、以及命令自身在符号链接场景下的微妙行为。本仓库中pwd的阿拉伯语页面位于 pages.ar/common/pwd.md与英文页面 pages.en/common/pwd.md 一一对应。二者都指向 GNU coreutils 官方文档中关于pwd的章节说明本条目描述的是 Linux/Unix 生态下的标准实现。pwd 是什么打印当前工作目录pwdprint working directory用于打印当前工作目录的完整路径。它是 shell 内建命令同时在 GNU coreutils 中提供独立的二进制实现。无论以哪种方式调用其核心语义都是回答一个问题我现在位于文件系统的哪个目录在 tldr 阿拉伯语页面中这一用途被表述为اطبع اسم الدليل الحالي打印当前目录的名称对应的核心命令只有一行pwd这一行看似简单却是绝大多数终端工作流的起点当你忘记自己身处何处、需要确认脚本的相对路径基准、或要在日志中记录执行位置时pwd都是第一选择。在自动化场景中pwd的输出经常被赋值给变量或拼接到路径中例如cd $(pwd)之类的幂等写法。与相邻命令的分工在 pages.en/common 目录中与pwd相邻的一批命令共同构成了路径工具族cd.md切换当前工作目录是pwd语义上的反向操作——cd改变位置pwd汇报位置basename.md从路径中剥离前导目录部分只保留文件名dirname.md从路径中剥离尾部文件名部分保留父目录realpath.md输出文件或目录解析后的绝对路径readlink.md读取符号链接的目标并可用-f获得绝对路径。理解这个家族关系有助于把握pwd -P的定位它本质上是在用pwd完成realpath的解析符号链接任务。当pwd -P与readlink -f、realpath产生相同结果时你可以确信路径解析没有歧义。核心选项-P与--physical到底解析了什么阿拉伯语页面的第二条目是全文的技术重点اطبع اسم الدليل الحالي و حل جميع الروابط اللينة (وبمعنى آخر إظهار المسار الفعلي)其含义为打印当前目录名称并解析所有软链接换言之显示真实路径。对应命令为pwd {{[-P|--physical]}}这里的{{[-P|--physical]}}是 tldr 的**选项占位符option placeholder**写法。根据仓库的 风格指南其规则是当选项既存在短形式-P又存在长形式--physical时用{{[-P|--physical]}}让 tldr 客户端自行决定展示短选项还是长选项详见 style-guide.md 附近的说明。也就是说这份速查表同时兼容喜欢-P的老派用户与偏好--physical的可读性用户。逻辑路径与物理路径的差别要理解-P的价值需要先理解一个事实当你cd进入一个符号链接目录后shell 默认记住的可能是链接路径而不是真实路径。举例说明ln -s /var/www /data/web/disk1/git_repo/GitHub_Trending/tl/tldr/web cd web pwd # 输出 .../tldr/web逻辑路径PWD 环境变量记录 pwd -P # 输出 /var/www物理路径逐个解析符号链接得到不带选项的pwd打印逻辑路径本质上是$PWD环境变量的值不做任何额外解析pwd -P/pwd --physical从根目录开始逐层解析所有路径分量将符号链接替换为其指向的真实目录输出最终的物理路径。这也是阿拉伯语页面用括号补充وبمعنى آخر إظهار المسار الفعلي即显示真实路径的原因——正是为了强调-P的输出与用户直觉中的链接路径可能不同。与 GNU coreutils 的对应关系两条目都通过 More information 行链接到 GNU coreutils 官方手册的pwd-invocation章节因此本文以下事实均以该标准实现为适用前提-Llogical是默认行为打印逻辑路径-Pphysical强制解析所有符号链接当两种行为结果不一致时pwd的退出状态仍为成功0因为命令本身执行没有错误。在 Bash 等主流 shell 中cd成功后会自动更新$PWD若cd进入的是一个符号链接目录默认$PWD保存链接路径这正是pwd -P存在意义的根源。tldr 页面结构与占位符规范pwd页面本身就是一个迷你版 tldr 格式范本。对照仓库 风格指南 的通用模板可以看出它完全符合规范第一行页面标题# pwd必须与命令名完全一致描述行以开头的一句话简介More information 行前缀的外部参考链接示例区块- 描述 空行 代码块每条示例至多两行描述占位符用户输入值用{{placeholder}}包裹以便客户端高亮。关于占位符风格指南给出几条与本条目直接相关的规则占位符内建议使用snake_case多词写法如{{path/to/file}}参见 style-guide.md路径类占位符统一采用{{path/to/placeholder}}格式选项占位符{{[-P|--physical]}}专用于长短选项二选一的场景参见 style-guide.md。值得注意的是英文页 pages.en/common/pwd.md 比阿拉伯语页多出第三条示例pwd --help即显示帮助。这说明翻译版本与英文主版本之间允许存在合理的差异如翻译页暂未同步新增示例也提示读者不同语言页面可能处于不同的维护进度。实战演练用 pwd 排查目录真相将pwd的两种行为组合起来可以形成一套可复现的路径排查流程第一步确认当前位置pwd记录输出作为后续所有相对路径的基准。若希望输出被脚本解析建议配合command pwd绕开 shell 函数或直接使用/bin/pwd。第二步验证是否存在符号链接干扰pwd -P比较两次输出。若两次结果一致说明当前目录不经过任何符号链接若不一致则说明你正处于某个链接路径之下物理路径已给出真实位置。第三步交叉验证可选readlink -f $(pwd) # 等价于解析当前路径的符号链接 realpath $(pwd) # 输出解析后的绝对路径当pwd -P、readlink -f、realpath三者输出一致时路径解析结果可以确信无疑。这三个命令分别有对应的 tldr 页面readlink.md、realpath.md可作为速查补充。第四步在脚本中安全使用current_dir$(pwd -P)在编写需要稳定路径的脚本时优先使用pwd -P可以避免因符号链接目录导致的路径漂移问题例如 CI 构建目录通过链接映射时。在 tldr 仓库中贡献 pwd 多语言页面pages.ar/common/pwd.md的存在本身就是一次成功的多语言贡献示范。若你想为其他语言补充或改进pwd页面可参考仓库 CONTRIBUTING.md 与 风格指南 的流程对照主版本翻译以 pages.en/common/pwd.md 为基准将描述与示例逐条翻译到目标语言目录如pages.xx/common/pwd.md保持结构与占位符页面标题、描述行前缀、代码块格式必须与模板一致占位符语法保持不变仅翻译描述文本本地校验仓库在 package.json 中声明了tldr-lint等校验依赖风格指南建议先运行tldr-lint path/to/tldr_page.md再提交参见 style-guide.md遵循语言专则风格指南末尾针对部分语言给出了专项建议翻译前应先查阅对应语言的风格段落。需要特别留意的是tldr 页面的文件名必须与命令名一致且为小写页面标题可以任意大小写但文件名必须小写参见 style-guide.md 的说明。pwd.md正是这一规则的典型体现。小结从一份不到十行的阿拉伯语速查页出发本文完成了三件事还原了pwd命令打印当前目录的基础用法拆解了pwd -P/--physical解析符号链接、输出物理路径的底层原理并把它放回 tldr 仓库的页面规范与路径工具族中说明了选项占位符{{[-P|--physical]}}的设计意图与多语言贡献方法。pwd的价值不在于复杂而在于它是判断我在哪、路径是否被链接的第一道工具。下次当你cd进一个快捷方式目录却找不到文件时不妨先执行pwd -P——你可能会发现答案一直在符号链接的另一端。关联仓库路径速查阿拉伯语页面pages.ar/common/pwd.md英文参考页面pages.en/common/pwd.md页面风格与占位符规范contributing-guides/style-guide.md相关命令cdpages.en/common/cd.md、readlinkpages.en/common/readlink.md、realpathpages.en/common/realpath.md、basenamepages.en/common/basename.md、dirnamepages.en/common/dirname.md贡献流程CONTRIBUTING.md赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐tldr 阿拉伯语页面解析dhclient 命令速查与实践指南tldr 阿拉伯语页面解析dhclient 命令速查与实践指南 本指南以 tldr 仓库中的阿拉伯语速查页 pages.ar/common/dhclient.文档教程知识库tldr 别名页实战解析阿拉伯语 sr 页面与背后的 surfraw 命令tldr 别名页实战解析阿拉伯语 sr 页面与背后的 surfraw 命令 本篇以 tldr 仓库中 pages.ar/common/sr.md https:文档教程知识库tldr 阿拉伯语页面解析以 exec 命令为例理解跨语言速查手册的编写规范tldr 阿拉伯语页面解析以 exec 命令为例理解跨语言速查手册的编写规范 导读 本文以 tldr 仓库中的 pages.ar/common/exec.md文档教程知识库上一篇TiDB 监控面板声明式管理使用 Jsonnet 生成与维护 Grafana Dashboard 完整指南下一篇初学者必看Devstral-Small-2-24B-Instruct-2512-4bit的核心功能与使用限制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考