• 文档
• 教程

本文基于 Linux 命令大全（linux-command）仓库中的 basename 命令文档，完整讲解 basename 命令的语法、选项、参数与实战用法：包括如何从带路径的文件名中剥离目录、如何结合命令替换构造同名前缀、异后缀的输出文件名，并对照仓库中 dirname 命令文档 与 构建脚本 中的实际应用，帮助你彻底掌握这一路径处理利器，能够在 Shell 脚本中写出更稳健、更可读的文件处理逻辑。

basename 命令是什么：从完整路径中提取基本名称

在 Linux 日常操作中，我们经常面对形如/home/jim/program.c的完整路径。很多时候，脚本只需要其中最后一段——即文件本身的名称program.c，而不关心它位于哪个目录。basename 命令正是为此而生：它打印目录或者文件的基本名称，即去除路径中的目录部分，只保留最后的文件名（或目录名）组件。

在 shell 脚本中，basename 常与 dirname 命令配合使用，用于命令替换（command substitution）来指定和输入文件名称有所差异的输出文件名称。例如把/data/logs/app.log处理成app.log后再追加新的后缀，这是日志轮转、备份归档、批处理脚本中最常见的需求之一。

语法与选项解析

语法

basename(选项)(参数)

命令的基本形态非常简单：传入一个带路径信息的字符串，basename 就会输出其中最后一段内容。

选项

--help：显示帮助信息； --version：显示版本号信息。

$ basename --help 用法：basename 名称 [后缀] 或：basename 选项 ... $ basename --version basename (GNU coreutils) ...

部分 GNU coreutils 版本还提供-a（同时处理多个参数）与-s（指定去除后缀）等扩展选项，但上述--help与--version是文档明确给出的两个最基础选项，适用于几乎所有发行版。

参数

• 文件：带路径信息的文件（必填），basename 会从中提取基本名称；
• 后缀：可选参数，指定要去除的文件后缀字符串。当文件基本名称以该后缀结尾时，后缀会被一并去除。

例如basename /home/jim/program.c .c会先提取program.c，再因为给定后缀.c而输出program。

实战示例：两个核心用法

示例一：显示一个 shell 变量的基本名称

要显示一个 shell 变量的基本名称，请输入：

basename $WORKFILE

此命令显示指定给 shell 变量WORKFILE的值的基本名称。如果WORKFILE变量的值是/home/jim/program.c文件，则此命令显示program.c：

$ WORKFILE=/home/jim/program.c $ basename $WORKFILE program.c

无论路径多深、包含多少层目录，basename 都只输出最后一段组件，这在脚本中提取文件名变量时极为常用。

示例二：构造一个和另一个文件名称相同（除了后缀）的文件名称

要构造一个和另一个文件名称相同（除了后缀）的文件名称，请输入：

OFILE=`basename $1 .c`.o

此命令指定给OFILE文件第一个位置上的参数（$1）的值，但它的.c后缀更改至.o。如果$1是/home/jim/program.c文件，则OFILE成为program.o。因为program.o仅是一个基本文件名称，它标识在当前目录中的文件。

拆解这一经典写法，可以看到 bash 中的三层协作：

1. $1是脚本或函数接收的第一个参数，此处为完整路径；
2. `basename $1 .c`用命令替换提取基本名称并去除.c后缀，得到program；
3. 再通过拼接.o，最终得到program.o——一个与输入文件同前缀、不同后缀的新文件名。

这条命令的妙处在于：无论调用脚本时传入的路径是/home/jim/program.c、./src/program.c还是相对的program.c，输出的OFILE都是纯净的program.o，落在当前目录，不会因路径层级而出现偏差。

更多实战：路径处理与边界场景

在掌握核心用法后，可以继续扩展到日常更常见的场景：

去除任意后缀，得到"基名"用于日志或备份文件命名：

$ basename /var/log/nginx/access.log .log access

配合循环批量处理文件，提取文件名做进一步操作：

for file in /data/uploads/*.tar.gz; do name=$(basename "$file" .tar.gz) echo "解压目录：$name" done

注意引号与路径尾斜杠的边界行为：当路径以/结尾（如basename /a/b/）时，basename 输出的往往是最后一个非空路径组件；当传入的参数不含任何/时（如basename a），输出就是参数本身。这些细节在不同实现上略有差异，脚本中建议对路径变量做好引号保护与判空处理。

basename 与 dirname：路径解析的一体两面

basename 提取文件名的同时，其姊妹命令 dirname 负责取出目录部分。仓库中的 dirname 命令文档 明确说明：dirname 命令去除文件名中的非目录部分，仅显示与目录有关的内容。dirname 命令读取指定路径名保留最后一个/及其后面的字符，删除其他部分，并写结果到标准输出。如果最后一个/后无字符，dirname 命令使用倒数第二个/，并忽略其后的所有字符。

$ dirname // 结果为 / $ dirname /a/b/ 结果为：/a $ dirname a 结果为 . $ dirname a/b 结果为路径名 a

对比可见：basename /home/jim/program.c得到program.c，而dirname /home/jim/program.c得到/home/jim。两者互补，正好把一条完整路径拆成"目录部分 + 文件名部分"。文档同样强调：dirname 和 basename 通常在 shell 内部命令替换使用，以指定一个与指定输入文件名略有差异的输出文件名——这正是前面OFILE=示例的底层逻辑。

结合仓库源码：basename 在 linux-command 项目中的实际应用

command 目录与索引生成

linux-command 仓库将每个命令的说明整理为独立的 Markdown 文件存放在 command 目录 下（如 basename.md、dirname.md），再通过 scripts/build.mjs 生成静态站点与索引数据 dist/data.json。

在 构建脚本 scripts/build.mjs 的createDataJSON函数中，项目正是用 Node.js 的path.basename从每个命令的 Markdown 文件路径中提取命令名，进而生成每个命令对应的访问路径：

// 命令路径 json["p"] = `/${path.basename(mdPath, '.md').replace(/\\/g, '/')}`;

这与 shell 中basename的语义完全一致：传入/xxx/command/basename.md，path.basename(mdPath, '.md')返回basename，再拼上前缀/得到/basename这样的页面路由。也就是说，我们在终端里用 basename 提取文件名，项目构建时用同名思路提取命令名——同一个概念贯穿了脚本编程与 Node.js 工具链。最终生成的 dist/data.json 中即可看到"basename": {"n": "basename", "p": "/basename", "d": "打印目录或者文件的基本名称"}这样的索引条目。

从源码看路径处理的重要性

该项目 README.md 提到仓库搜集了 600 多个 Linux 命令，全部命令文档都以command/<命令名>.md的扁平结构存放。若没有 basename / path.basename 这类"剥离路径、提取组件"的能力，无论是构建脚本的索引生成，还是脚本中对用户输入路径的二次加工，都会因为目录层级、后缀差异而变得繁琐易错。这正是 basename 命令在真实工程中被反复使用的原因。

小结：什么时候该用 basename

basename 虽小，却是 Shell 脚本中最基础也最可靠的文件路径处理工具之一。掌握它与 dirname 的配合，再结合本文给出的命令替换写法，你就能在处理文件批量转换、日志归档、备份命名等任务时，写出不依赖路径层级、稳健可移植的脚本逻辑。更多命令详解可在本仓库 command 目录 中按需查阅。

• 文档
• 教程