ZeroTermux 内置 Linux 命令手册解读：pushd 目录栈命令详解与实战
ZeroTermux 内置 Linux 命令手册解读：pushd 目录栈命令详解与实战
导读
pushd 是 Shell（Bash）内置的目录栈管理命令，用于把目录压入"目录堆叠"（directory stack）并自动切换工作目录，配合 popd、dirs 即可在不反复输入 cd 的情况下在多个目录之间来回穿梭。本文以 ZeroTermux 仓库内置的命令手册文档 pushd.md 为骨架，结合仓库中配套的 dirs.md、popd.md 以及命令文档的渲染实现源码，完整讲解 pushd 的语法、选项、参数与实例，并说明在 ZeroTermux 终端环境中如何查阅与使用这套命令手册。
pushd 是什么：将目录加入命令堆叠
根据仓库内置文档 pushd.md 的定义，pushd 命令 是将目录加入命令堆叠（目录栈）中。其核心行为包括：
- 如果指令没有指定目录名称，则会将当前的工作目录置入目录堆叠的最顶端；
- 置入的目录如果没有指定堆叠的位置，也会置入目录堆叠的最顶端；
- 与此同时，工作目录会自动切换到目录堆叠最顶端的目录去。
简单来说，pushd 新目录 等价于"记住我当前所在的位置，然后 cd 到新目录"。由于 Shell 会记住整个目录栈，之后可以用 popd 一步步"回退"，或在栈中任意跳转，这是比 cd -（只能记住上一个目录）更强大的目录导航方式。
pushd、popd、dirs 是 Bash 内置命令（builtin），不需要额外安装任何软件包，在 ZeroTermux 的终端会话中可以直接使用，也常被用于编写 Shell 脚本时临时切换目录而不污染脚本的当前工作目录。
语法与选项详解
pushd 的语法格式（继承自 pushd.md）：
pushd(选项)(参数)
各选项的含义如下：
| 选项 | 含义 |
|---|---|
-n |
只加入目录到堆叠中，不进行 cd 操作 |
+n |
处理从左到右数起的第 n 个目录，数字从 0 开始 |
-n |
处理从右到左数起的第 n 个目录，数字从 0 开始 |
参数部分即目录：需要压入堆栈的目录路径。
需要特别留意的是，-n 出现在两个不同的位置，含义完全不同：
- 作为独立的第一个选项（
pushd -n 目录）时，表示"只入栈、不切换目录"，即把目录压入栈顶，但当前工作目录保持不变； - 作为带数字的下标参数（
pushd +n/pushd -n）时，表示按位置处理目录栈中的第 n 个目录，数字从 0 开始计数。
与 Bash 实际语义的对照：旋转（rotate）而非删除
按 Bash 手册的标准语义，pushd +N 与 pushd -N 实际执行的是目录栈旋转：将指定位置的目录旋转到栈顶，并切换当前工作目录到该目录，而不是"删除"栈中记录。删除操作由 popd +N / popd -N 负责。
这一区别可以从 pushd.md 自带的实例输出中得到印证：
root@Mylinux:/tmp/dir2# pushd -1
/tmp/dir1 ~ /tmp/dir2 /tmp/dir3 /tmp/dir4
执行前目录栈为 /tmp/dir2 /tmp/dir3 /tmp/dir4 /tmp/dir1 ~，从右数第 1 个（下标从 0 开始）目录是 /tmp/dir1；pushd -1 将其旋转到栈顶，栈变为 /tmp/dir1 ~ /tmp/dir2 /tmp/dir3 /tmp/dir4，目录总数保持不变——如果是"删除"，输出中应当少一个目录。
参数：需要压入堆栈的目录
pushd 的参数是目录，即需要压入堆栈的目录路径，可以是绝对路径（如 /tmp/dir3）或相对路径，也支持 ~ 等快捷符号（仓库文档实例中的 ~ 即代表用户主目录）。
不带参数调用 pushd 时，会把当前目录压入栈顶并自动切换目录。结合选项，还有以下典型用法：
pushd /path/to/dir：把目录压入栈顶并切换工作目录；pushd -n /path/to/dir：只压入栈、不切换目录；pushd +N/pushd -N：旋转目录栈，使指定位置的目录成为栈顶并切换过去。
实例演示：目录栈的完整工作流
逐步压入目录并观察栈变化
以下实例完整继承自 pushd.md：
root@Mylinux:/tmp/dir4# pushd /tmp/dir3
/tmp/dir3 /tmp/dir4 /tmp/dir1 ~
root@Mylinux:/tmp/dir3# pushd /tmp/dir2
/tmp/dir2 /tmp/dir3 /tmp/dir4 /tmp/dir1 ~
root@Mylinux:/tmp/dir2# pushd -1
/tmp/dir1 ~ /tmp/dir2 /tmp/dir3 /tmp/dir4
注意：最左边表示栈顶，最右边表示栈底。 每次 pushd 后：
- 第一次
pushd /tmp/dir3：/tmp/dir3入栈顶，当前目录切换到/tmp/dir3，栈为/tmp/dir3 /tmp/dir4 /tmp/dir1 ~； - 第二次
pushd /tmp/dir2：/tmp/dir2入栈顶，当前目录切换到/tmp/dir2，栈为/tmp/dir2 /tmp/dir3 /tmp/dir4 /tmp/dir1 ~； pushd -1：从右数第 1 个目录/tmp/dir1被旋转到栈顶，当前目录切换到/tmp/dir1，栈为/tmp/dir1 ~ /tmp/dir2 /tmp/dir3 /tmp/dir4。
用 dirs 随时查看目录栈
与 pushd 配套的是 dirs 命令，用于显示目录栈中的所有记录。根据 dirs.md 的说明，不带参数的 dirs 始终显示当前目录，再显示堆栈中的内容；即使目录堆栈为空，dirs 命令仍然只显示当前目录。
常用选项：
| 选项 | 含义 |
|---|---|
-c |
删除目录栈中的所有记录 |
-l |
以完整格式显示（不缩写 ~ 等符号） |
-p |
一个目录一行的方式显示 |
-v |
每行一个目录显示，每个目录前加上编号 |
+N |
显示从左到右第 n 个目录，数字从 0 开始 |
-N |
显示从右到左第 n 个目录，数字从 0 开始 |
实例（来自 dirs.md）：
[root@localhost etc]# dirs
/etc
即当前目录为 /etc、目录栈为空时，dirs 仍显示 /etc。在 pushd 压入多个目录后，可用 dirs -v 查看带编号的完整栈内容，方便确认后续 +N / -N 的下标位置。
用 popd 弹出目录栈
popd 用于删除目录栈中的记录。根据 popd.md，如果不加任何参数，popd 会先删除目录栈最上面的记录，然后切换到删除后目录栈中最上面的目录。
| 选项 | 含义 |
|---|---|
+N |
将第 N 个目录删除（从左边数起，数字从 0 开始） |
-N |
将第 N 个目录删除（从右边数起，数字从 0 开始） |
-n |
目录出栈时，不切换目录 |
实例（来自 popd.md）：
root@Mylinux:/tmp/dir4# popd（相当于popd +0）
/tmp/dir3 /tmp/dir2 /tmp/dir1 ~
root@Mylinux:/tmp/dir3# pushd /tmp/dir4
/tmp/dir4 /tmp/dir3 /tmp/dir2 /tmp/dir1 ~
root@Mylinux:/tmp/dir4# popd +1
/tmp/dir4 /tmp/dir2 /tmp/dir1 ~
root@Mylinux:/tmp/dir4# popd -2
/tmp/dir4 /tmp/dir1 ~
由此可见，popd 的下标选项是真正意义上的"删除"——popd +1 删除从左数第 1 个目录，popd -2 删除从右数第 2 个目录，栈中的目录数量随之减少。
三命令组合的典型使用模式
在终端中可将三者组合成"前进—查看—回退"的工作流：
$ pushd /project/build # 压入目录并切换
$ dirs # 查看当前目录栈
$ make # 在目标目录执行任务
$ popd # 弹出栈顶并回到之前的目录
在 Shell 脚本中，pushd / popd 的 -n 选项（入栈/出栈均不切换目录）尤其有用，可以只记录位置而不影响脚本的执行目录。
选项易混淆点与注意事项
结合 pushd.md、popd.md 与 Bash 语义，使用时有几个容易踩坑的点：
- 栈顶在左边，栈底在右边：
dirs/pushd的输出中，最左边是栈顶（当前工作目录通常位于栈顶），最右边是栈底，且数字下标从 0 开始。 +n与-n的方向不同：+n从左边（栈顶方向）数起，-n从右边（栈底方向）数起，二者不可混用。- pushd 的
+N/-N是旋转，popd 的+N/-N才是删除：pushd 旋转后目录栈元素个数不变，popd 删除后元素个数减少。 -n的双重含义：pushd -n 目录表示"只入栈不切换目录"，而pushd -N（带数字）表示按下标旋转；判断依据是-n后面跟的是目录路径还是数字。~缩写：目录栈输出中~表示用户主目录，若需展开为完整路径可使用dirs -l。
ZeroTermux 中的命令手册：内置文档与渲染机制
命令手册的存放位置
ZeroTermux 在应用内内置了一套 Linux 命令手册，文档以 Markdown 格式存放在仓库的 assets/cmd 目录下，其中就包括本文主角 pushd.md，以及同族的 dirs.md、popd.md。该目录下还收录了 cd、pwd、ls、mkdir、rm 等大量常用命令的说明文档，构成一份可直接离线查阅的命令速查手册。
文档的加载与渲染实现
从源码看，这套手册由 CommandDialog 负责呈现。在 CommandDialog.java 中：
- 初始化数据时，通过
AssetManager列出cmd目录下的全部文档文件（对应源码 CommandDialog.java 中的assetManager.list("cmd")）； - 支持按命令名实时搜索过滤，输入关键字后对命令列表执行包含匹配并按字母序排序（对应 CommandDialog.java 的
TextWatcher逻辑）； - 点击某条命令后，使用
commonmark解析对应 Markdown 文档，并渲染到WebView中展示（对应 CommandDialog.java 的showCmdDetail方法：assetManager.open(String.format("cmd/%s", cmd))打开文档，Parser解析、HtmlRenderer渲染后由web_view.loadData展示）。
也就是说，你在 ZeroTermux 的命令手册面板中看到的 pushd 语法、选项表格与实例，正是本文所引用的这份 pushd.md 被实时解析渲染后的结果，文档与代码逻辑一一对应，可在终端与手册之间无缝对照学习。
在实际终端中的验证建议
在 ZeroTermux 中打开终端会话，即可直接验证本文全部命令（pushd、popd、dirs 均为 Bash 内置命令，开箱即用）：
~ $ pushd $PREFIX
/data/data/com.termux/files/usr /data/data/com.termux/files/home
~ $ dirs -v
其中 $PREFIX 是 Termux 环境中的软件安装前缀（通常为 /data/data/com.termux/files/usr）。验证完成后可用 popd 回到原目录，并用 dirs -c 清空目录栈。
总结
pushd 是 Bash 目录栈机制的核心入口：pushd 压入并切换，dirs 查看栈内容，popd 弹出栈记录，三者配合即可实现多目录的高效往返与脚本内安全的临时目录切换。本文完整继承了仓库内置文档 pushd.md 的语法、选项、参数与实例，并对照 dirs.md、popd.md 澄清了 +N / -N 下标方向、-n 的双重含义以及"旋转"与"删除"的区别。在 ZeroTermux 中，这份手册随应用内置、可离线检索，配合真实终端即可边查边练，是掌握目录栈命令的可靠参考。