Linux dirname 命令:提取目录部分,处理斜杠与脚本路径

dirname从路径字符串中去掉最后一个文件名或目录名,输出前面的目录部分。它适合在 shell 脚本中计算输出文件的上级路径,但不检查目录是否存在,也不解析符号链接或把相对路径变成绝对路径。

dirname 的作用

要取得一个路径除去最后组成部分后的字符串,可以执行:

dirname /home/user/report.txt

输出为:

/home/user

最后名称实际指向文件、目录,还是根本不存在,都不影响这项字符串计算。不要把成功输出路径误当作权限检查通过,或误认为命令已经找到了文件系统中的真实父目录。

基本语法与使用方法

dirname name...

name... 是名称参数的占位符,不应原样输入。GNU dirname 接受一个或多个路径,每项默认输出一行;POSIX 的基本形式只规定一个字符串参数。先看三次独立调用:

dirname /var/log/nginx/access.log
dirname /home/user/Documents/
dirname relative/path/file.txt

依次输出 /var/log/nginx、/home/user 和 relative/path。命令先忽略末尾多余的斜杠,再去掉最后组成部分及其前面的分隔斜杠,因此不能用于逐字保留原始路径的写法。

不同输入形式的结果

以下示例使用常见的 Unix 路径表示法;输出是路径字符串,不是文件类型判断:

输入 输出
/home/user/report.txt /home/user
docs/manual.pdf docs
notes.txt .
/usr/ /
/ /

没有斜杠的名称

输入中没有斜杠时,结果是表示当前目录的点:

dirname report.txt
.

它并不证明当前目录内存在 report.txt。空字符串的结果同样是 .;这一点不要与 GNU basename 对空字符串的处理混淆。

绝对路径与根路径

去掉最后名称后只剩根目录时,结果保留根目录斜杠:

dirname /etc
dirname /

两个调用都输出 /。恰好两个斜杠 // 具有平台相关的特殊边界:GNU 在将它与 / 区别对待的平台上可能保留 //,不能假定所有 Unix 系统都输出单个斜杠。

末尾斜杠、重复斜杠与点组件

dirname /srv/www/site/
dirname /srv/www/site///

两次都输出 /srv/www;末尾斜杠并不表示保留 site 这一层。在可移植脚本中,也不要依赖多余斜杠和 . 组件一定保留或一定全部消除。POSIX 允许部分简化,但输出路径中位于最后组件之前的 .. 不能随意删除,因为正确消除它可能需要解析文件系统。

一次处理多个路径

GNU 的多个名称参数

GNU 实现可直接列出多个名称,不需要 basename 的 -a 选项:

dirname /srv/www/index.html /var/log/syslog /home/user/file.txt

按输入顺序输出:

/srv/www
/var/log
/home/user

多个输入是多个独立参数,不是把一串路径放进一个变量后交给命令自动拆分。每个可能含空格的路径都应独立加引号。

用 -z 生成 NUL 分隔输出

GNU 的 -z 或 --zero 用 NUL(值为零的字节)结束每项,避免结果中包含换行时混淆项目边界:

dirname -z /srv/www/index.html /var/log/syslog

输出字节可表示为 /srv/www\0/var/log\0,其中 \0 是 NUL 的示意写法,不是两个普通字符。下游程序也必须支持这种分隔方式;命令不会因为加了 -z 就从标准输入读取名称列表。

不要用普通 shell 变量保存 NUL 分隔数据。默认换行输出放入 $(...) 时,末尾换行也会被删除;下文简短脚本适用于一般路径,不能当作无损处理任意含换行名称的协议。

与 basename 配合拆分路径

下面的独立脚本片段分别取得目录和最后名称。路径无需真实存在,变量均保留双引号;任一命令失败时退出所在脚本:

path='/home/user/docs/report.pdf'
directory=$(dirname -- "$path") || exit 1
name=$(basename -- "$path") || exit 1

printf '目录:%s\n' "$directory"
printf '名称:%s\n' "$name"

输出为:

目录:/home/user/docs
名称:report.pdf

basename 的名称与后缀处理负责最后名称,dirname 负责此前的目录部分。二者适合按含义拆分路径,但将结果用一个斜杠拼回去,不保证恢复输入中的重复斜杠、末尾斜杠或特殊写法。

在 shell 脚本中使用

先创建输出文件的上级目录

在允许写入的工作目录内,可运行以下完整示例。它只在当前目录下创建专用演示目录 dirname-demo/backups/daily,不会生成 archive.tar.gz 文件:

output='./dirname-demo/backups/daily/archive.tar.gz'
output_dir=$(dirname -- "$output") || exit 1
mkdir -p -- "$output_dir"

成功后应能看到该目录层级;若已经存在,mkdir -p 可正常结束。这个选项仍可能因权限不足、同名位置其实是普通文件等情况失败,不能把 dirname 成功当作 mkdir 成功。该片段把 mkdir 放在最后,其状态也就是片段的最终状态;若后面还有写文件步骤,应检查 mkdir 的退出状态后再继续。

只为试验新建且仍为空的目录,可以按从内到外的顺序用 rmdir 删除;不要删除运行前已存在或已包含其他文件的目录。对不可信路径,还须另外验证允许的基准目录和实际对象;dirname 不会限制 ..、符号链接或访问范围,也不能防止检查与使用之间的路径变化。

与 POSIX shell 参数展开比较

对输入格式明确的简单路径,也可以在 shell 内部删除最后一段:

path='/srv/www/index.html'
directory=${path%/*}
printf '%s\n' "$directory"

输出 /srv/www。${path%/*} 删除匹配斜杠及后面内容的最短后缀,但不是 dirname 的通用替代品:输入 file.txt 时展开仍为 file.txt,dirname 为 .;输入 / 时展开为空,dirname 为 /;输入 /srv/www/ 时展开为 /srv/www,dirname 为 /srv。输入多样时,应逐一验证边界。

与 realpath、pwd 的区别

命令 处理对象 主要结果
dirname 输入路径字符串 最后名称之前的目录部分。
basename 输入路径字符串 最后一个文件名或目录名。
realpath 指定路径,按选项结合文件系统解析 规范化的绝对路径;符号链接及不存在组件的处理取决于选项。
pwd 当前进程的工作目录 当前工作目录的绝对路径。

dirname ../logs/app.log 只输出 ../logs,不会把它改成当前目录下的绝对路径,也不追踪符号链接。需要判断当前工作位置时,使用 pwd 的逻辑或物理路径查询;需要解析另一个路径时再选择适合目标和存在性要求的 realpath 选项。

GNU 选项速查

选项 用途
-z、--zero 每项结果以 NUL 代替换行结束。
--help 显示本机实现支持的用法和选项。
--version 显示已安装 GNU Coreutils 的版本。
-- 结束选项解析,后续参数按名称处理。

POSIX(可移植操作系统接口)规定的基本形式是 dirname string。多个名称参数及 -z 等 GNU 扩展应按目标系统的实现确认;不要把 Windows 路径中的反斜杠当作这里讨论的 Unix 目录分隔斜杠。

常见问题与排查

结果为什么是一个点?

输入没有目录分隔斜杠,或输入为空,dirname 就输出 .。这是字符串规则下的目录部分,不是把真实路径解析到当前目录。

输出目录为什么不存在?

命令不检查文件系统。使用结果前应根据操作需要检查存在性、目录类型和访问权限;需要创建目录时,要另行执行创建操作并处理失败状态。

空格、通配符或连字符导致参数异常

沿用前文已赋值的 path 时,应保留双引号,并在名称前结束选项解析:

dirname -- "$path"

双引号避免单词拆分和文件名通配展开,-- 避免以连字符开头的名称被误作选项;这两者处理不同问题。还应确认输入确实使用 Unix 斜杠路径,不能用成功退出状态证明路径格式符合业务要求。

常见问答

dirname 会查找真实父目录吗?

不会。它按字符串规则去掉最后组件,不检查路径是否存在、文件类型或符号链接。

dirname file.txt 为什么输出点?

因为输入没有目录分隔斜杠,命令用 . 表示该名称对应的目录部分。

能同时处理多个路径吗?

GNU dirname 可以,且按参数顺序逐项输出。需要在不同 Unix 实现间移植时,应先确认支持形式。

需要绝对路径时该用 dirname 吗?

dirname 不会把相对路径转换为绝对路径。需要规范化另一个路径时,应选择满足存在性和链接处理要求的 realpath 选项;查询当前工作目录则使用 pwd。

参考资料