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 通常输出表示当前目录的点。




