Linux basename 命令:提取路径末尾名称与删除后缀

basename从路径字符串中提取最后一个文件名或目录名,并可删除明确指定的末尾后缀。它适合在 shell 脚本中生成显示名称;只计算字符串,不会重命名文件、打开文件或检查路径是否存在。

basename 能做什么?

只需要路径最后一个组成部分时,可以直接传入该路径:

basename /home/user/report.txt

输出为:

report.txt

即使这个文件并不存在,也会得到相同的结果。输入是文件路径还是目录路径并不影响计算;命令会先处理末尾斜杠,再取最后的名称。它不会解析符号链接,也不能代替文件存在性或访问权限检查。

基本语法与路径示例

basename name [suffix]
basename options name...

第一种形式接受一个名称和可选后缀;方括号表示可以省略,不要照原样输入。第二种形式配合 GNU 的多名称选项使用,options 和 name... 也只是语法占位符。实际命令例如:

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

这三次调用依次输出 access.log、Documents 和 file.txt。相对路径同样可用;末尾的多余斜杠不会被当作空文件名。

根路径 / 的结果仍是 /,全部由斜杠组成的普通输入也会归为根路径。空字符串与恰好两个斜杠 // 是可移植性边界:GNU 对空输入输出空字符串,而 POSIX 允许实现选择空字符串或点;// 的结果取决于平台是否赋予它特殊含义。不要把这些输入硬编码为所有 Unix 系统都相同的结果。

删除指定后缀

把后缀作为第二个参数

在路径后提供一个后缀参数,只有最后名称以该字符串结尾时才删除:

basename /data/archive.tar.gz .gz
basename /home/user/report.txt .txt

两行分别输出 archive.tar 和 report。要删除整个复合后缀 .tar.gz,需要完整指定它:

basename /data/archive.tar.gz .tar.gz

结果是 archive。后缀按字面值、区分大小写地匹配,不是正则表达式或通配符;不匹配也不是错误,名称保持不变。一个容易遗漏的例外是:后缀若等于整个最后名称,不会把名称全部删成空串。例如名称 file.txt 配后缀 file.txt,结果仍是 file.txt。包含斜杠的后缀也不能用于删除目录部分。

用 -s 同时处理多个名称

GNU basename 的 -s 或 --suffix 把后缀放在选项中,并自动启用多名称处理:

basename -s .jpg /images/a.jpg /backup/b.jpg
basename --suffix=.log /var/log/app.log /tmp/test.log

第一行依次输出 a、b,第二行依次输出 app、test;每个名称独立判断是否匹配。选项应放在名称参数之前。

处理多个路径与输出分隔符

-a 将每个参数当作一个名称

-a 或 --multiple 使每个参数都按名称处理,默认每项输出一行:

basename -a /srv/www/index.html /var/log/syslog /home/user
index.html
syslog
user

没有 -a 或 -s 时,两个普通参数会按“名称、后缀”理解,不能据此处理两个路径。启用 -a 后如果还要去后缀,应使用 -s 指定,不能再依赖第二个普通参数。

-z 输出 NUL 分隔的数据

文件名可以包含换行,按行分隔的结果因此可能有歧义。GNU 的 -z 或 --zero 用 NUL(值为零的字节)结束每项:

basename -z -a /data/file1 /data/file2

输出字节相当于 file1\0file2\0,其中 \0 表示 NUL 字节,并非反斜杠和数字零。屏幕上可能看不到分隔符;下游程序必须支持 NUL 分隔。这个选项改变的是输出终止符,命令仍从参数接收名称,不会因此从标准输入读取 NUL 名称列表。

不要把 NUL 输出放进普通 shell 变量;命令替换不适合保存这种数据。即使用默认换行输出,$(...) 也会删除末尾换行,因此下文简短脚本适用于一般名称,不能声称无损覆盖名称本身以换行结尾的情况。

basename 与 dirname 的区别

basename 取最后名称,dirname 取去掉最后名称后的目录部分。两者都处理字符串,不会验证文件系统中的对象:

输入路径 basename 输出 dirname 输出
/home/user/report.txt report.txt /home/user
docs/manual.pdf manual.pdf docs
notes.txt notes.txt .
/ / /

它们可以互补地拆分路径,但把两个输出直接用斜杠重新拼接,不保证还原原始字符串:末尾斜杠、重复斜杠和特殊输入都可能被规范化。这里讨论的是命令行工具,不能直接套用同名 C 库函数的所有边界行为。

文件扩展名应按规则处理

删除已知扩展名

已知要删除哪种扩展名时,明确提供后缀最容易核对:

basename photo.webp .webp
basename backup.tar.gz .tar.gz

分别输出 photo 和 backup。对 report.txt.bak 指定 .txt 不会删除中间部分,因为它并非当前名称的末尾。

不要把最后一个点之后都当作扩展名

.profile 是以点开头的隐藏文件名,archive.tar.gz 有复合后缀,也存在以点结尾的名称。basename 不负责识别文件格式,更不会猜测哪部分是业务上的扩展名。

先确定允许删除的后缀和大小写规则,再选择操作。直接删除最后一个点及其后内容,可能把隐藏名称或本来有意义的点号处理错。

在 shell 脚本中提取名称

保留空格并处理失败状态

下面是可独立执行的 shell 片段;它不需要该路径真实存在。成功时输出 文件名:annual report.pdf,命令失败则退出所在脚本:

path='/srv/uploads/annual report.pdf'
name=$(basename -- "$path") || exit 1
printf '文件名:%s\n' "$name"

-- 结束选项解析,让后面的名称即使以连字符开头也不被当成选项。给变量加双引号可避免单词拆分和文件名通配展开;只加引号并不能结束选项解析,这两种处理作用不同。

获得显示名称并不表示文件可读或可信。如果后续要读取、移动或删除文件,仍须另行检查对象并使用适合该操作的路径;不要因成功获得名字就认定实际文件存在。

与 POSIX shell 参数展开比较

输入格式明确时,也能在 shell 内部提取最后部分,避免调用外部程序:

path='/srv/uploads/report.pdf'
name=${path##*/}
printf '%s\n' "$name"

这里输出 report.pdf。${path##*/} 删除到最后一个斜杠为止的最长前缀,但它并不复现 basename 的末尾斜杠规则:对 /srv/uploads/ 或根路径 /,这种展开会得到空串,而 basename 分别得到 uploads 和 /。只有在输入约束清楚时才能把两者互换。

主要 GNU 选项

选项 用途
-a、--multiple 把每个名称参数分别处理并输出。
-s suffix、--suffix=suffix 删除匹配的末尾后缀,同时启用多个名称处理。
-z、--zero 每项以 NUL 代替换行结束。
--help 显示本机实现的用法和选项。
--version 显示已安装 GNU Coreutils 的版本。

-a、-s、-z 等是 GNU 扩展。POSIX(可移植操作系统接口)规范的基本形式是一个字符串和可选后缀;写给不同 Unix 平台的脚本,应核对目标实现,不能假定这些扩展处处存在。

常见问题与排查

文件不存在却有输出

这是正常行为;basename 不访问目标文件。检查字符串处理是否正确,与检查文件是否存在、是否有权限,是不同的任务。

含空格路径被拆成多个参数

检查变量是否被双引号包住。下例沿用前文已经赋值的 path:

basename -- "$path"

未加引号时,空格可能触发单词拆分,星号等字符还可能被 shell 展开。保留引号,并在名称前结束选项解析;若多名称调用结果不对,也要检查是否漏了 -a。

后缀没有被删除

核对末尾是否完全匹配、大小写是否一致,以及后缀是否等于整个最后名称。确认没有把 *.txt 当作匹配规则;这里需要的是字面后缀 .txt。不匹配通常仍返回成功状态,不能只凭退出状态判断后缀已被删除。

常见问答

basename 会修改实际文件名吗?

不会。它只在标准输出写出计算出的名称,不重命名或修改文件、目录。

怎样删除 .txt 扩展名?

例如 basename /data/report.txt .txt 输出 report。GNU 环境处理多个名称时可用 basename -s .txt /data/a.txt /tmp/b.txt;后缀必须匹配名称末尾。

路径不存在也能使用吗?

可以。命令只处理路径字符串;输出一个名字并不能证明该文件存在。

dirname 和 basename 分别返回什么?

basename 返回最后名称,dirname 返回此前的目录部分;仅有文件名时,dirname 通常输出表示当前目录的点。

参考资料