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。




