• 文档
• 教程

builtin是 Bash 提供的一个特殊内建命令，用于强制执行某个 bash 内建命令，并且在解析命令时优先于同名的 shell 函数与外部命令。本文以 command/builtin.md 为骨架，结合仓库中 enable、type、alias、command、help 等命令手册，系统讲解 builtin 的语法、返回值、命令优先级机制，并通过可复现的终端示例，帮你彻底解决"同名命令到底执行哪一个"的问题。

命令简介与概要

builtin命令的作用非常单一：执行指定的 bash 内建命令。其标准语法为：

builtin [shell-builtin [arg ...]]

• shell-builtin（可选）：要调用的 bash 内建命令名称；
• arg（可选）：传递给该内建命令的一个或多个参数。

当不带任何参数执行builtin时，什么都不会发生（它本身不列出内建命令列表）；只有当给出内建命令名时，它才会将剩余参数完整转交给对应的内建命令执行。

主要用途

• 用于执行指定的 bash 内建命令；
• builtin命令调用的 bash 内建命令优先于同名的外部命令及同名的 shell 函数——这是它区别于普通命令调用的核心价值。

换句话说，builtin为脚本作者提供了一条"绕过函数遮蔽、直达内建实现"的通道。当你定义了与内建命令同名的 shell 函数，又想调用真正的内建版本时，builtin就是最直接的解法。

返回值

builtin返回其调用的内建命令的执行返回值，但存在两个例外场景会报错：

1. 传递的名字不是 bash 内建命令；
2. 该内建命令被禁用了（关于禁用内建命令见下文 enable 命令 一节）。

因此，builtin的返回值可以理解为"内建命令执行结果的透传"，这使其可以安全地用于脚本中的条件判断，例如：

if builtin type -t echo; then echo "echo 是内建命令" fi

核心原理：Bash 的命令查找优先级

理解builtin，首先要理解 Bash 解析一个命令名时的查找顺序。仓库中 type 命令手册给出了命令类型的完整集合：别名（alias）、关键字（keyword）、函数（function）、内建（builtin）、文件（file），这正是 Bash 自上而下的查找优先级。

command/builtin.md 中给出的同名情况下的优先级顺序为：

builtin 内建命令 > 函数 > 内建命令 > 外部命令

其中"builtin 内建命令"特指通过builtin强制调用的内建命令。将这个特例还原到 Bash 完整的查找链路，实际规则是：

别名 > 关键字 > 函数 > 内建命令 > 外部命令（$PATH 中查找）

而builtin echo ...会将"内建命令"这一层提升到函数之前，从而优先于同名的 shell 函数执行；只有当builtin调用的名字并非内建命令（或已被禁用）时，才可能回落报错，而不是自动转去执行函数或外部命令。

用 type 命令验证类型

type命令是验证上述优先级的最佳工具。在未定义同名函数、未禁用内建命令的前提下：

# type 返回命令类型（builtin） type -t echo # 输出：builtin # printf 同时是内建命令以及可执行文件（GNU coreutils），优先作为内建处理 type -t printf # 输出：builtin # 没有内建版本的外部命令，类型为 file type -t chmod # 输出：file # bash 关键字 type -t for # 输出：keyword

可见type -t返回的永远是优先级最高的那个类型，这从侧面印证了"内建命令 > 外部命令"的查找次序。相关的-a（列出 PATH 中全部可执行路径）、-p、-P、-f选项的详细行为，可参考 command/type.md。

实战示例：同名命令的执行控制

示例一：函数遮蔽内建命令后，用 builtin 找回内建行为

这是builtin最典型的应用场景。假设当前 shell 中echo是内建命令，我们为其定义一个同名函数：

# 关于外部命令优先级最高的情况请参考 enable 命令 # 此时内建命令优先使用 echo "the Great Wall" # 调用内建命令 type，返回命令的类型（builtin） type -t echo # 定义 echo 函数 echo() { printf "123\n" } # 此时同名函数优先使用，显示（123） echo # 调用内建命令 type，返回命令的类型（function） type -t echo # 此时内建命令优先使用 builtin echo -e "backslash \\"

逐步解读：

1. 未定义函数前，echo直接命中内建命令，type -t echo返回builtin；
2. 定义echo函数后，普通调用echo命中函数，输出123，type -t echo变为function；
3. 使用builtin echo -e "backslash \\"时，绕开函数层，强制执行内建的echo，并正确解析-e选项与转义字符，输出backslash \。

这个例子同时演示了builtin的两个关键点：强制指定内建命令、参数原样透传（-e与转义序列均由内建 echo 处理）。

示例二：builtin 调用 alias 输出系统别名

builtin也可以与其他内建命令组合。比如强制调用内建alias，输出当前系统环境下的全部命令别名：

builtin alias # 输出示例（不同发行版略有差异） alias cp='cp -i' alias l.='ls -d .* --color=tty' alias ll='ls -l --color=tty' alias ls='ls --color=tty' alias mv='mv -i' alias rm='rm -i' alias which='alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde'

注意：builtin alias与直接执行alias在无同名函数遮蔽时结果一致；若环境中存在名为alias的函数，builtin alias能确保执行的是内建版本。关于别名的定义、持久化（写入~/.bashrc或/etc/bash.bashrc）与删除，可分别参考 command/alias.md 与 command/unalias.md。

与 enable 命令配合管理内建命令

builtin手册的注意事项明确指出：如果要调用的内建命令被禁用了（包括builtin本身），那么执行会报错。启用与禁用内建命令由 enable 负责，其语法为：

enable [-a] [-dnps] [-f filename] [name ...]

常用选项：

典型用法：

# 禁用两个 POSIX 标准内建命令 enable -n set source # 打印处于禁用状态的 POSIX 标准内建命令 enable -ns # 打印 POSIX 标准内建命令，无论是否禁用 enable -as # 打印处于启用状态的 POSIX 标准内建命令 enable -s

# 禁用 echo、pwd 两个内建命令 enable -n echo pwd # 打印所有内建命令，无论是否禁用 enable -a # 打印处于启用状态的内建命令 enable # 打印处于禁用状态的内建命令 enable -n # 重新启用 pwd 内建命令 enable pwd

禁用内建命令后，优先级链会发生改变。以echo为例（引用 command/enable.md 的说明）：

• 当内建命令echo未被禁用时，若要调用外部命令echo，只能显式写全路径/usr/bin/echo；
• 当禁用了内建echo后，优先级顺序变为：函数 > 外部命令。若环境中没有echo函数，那么调用echo命中的就是$PATH中的外部命令。

这也解释了 command/builtin.md 中"关于外部命令优先级最高的情况请参考 enable 命令"的注释：默认情况下内建命令优先级高于外部命令，只有通过enable -n禁用它，外部命令才能"上位"。同时请注意，enable自身也是可以被禁用的内建命令——一旦enable -n enable生效，后续将无法再用enable启用或禁用任何内建命令（包括builtin也会受禁用影响）。

与 command 命令的对比

仓库中的 command/command.md 讲解了另一个容易混淆的命令：command同样用于"调用并执行指定的命令"，但执行时不查询 shell 函数，且只能够执行 shell 内部的命令。例如：

command echo Linux # 输出：Linux

两者对比如下：

一句话总结：当你明确知道要执行的是"内建命令本身"时用builtin；当你只想"绕过函数层、按正常路径执行命令"时用command。

常见陷阱与注意事项

1. builtin是 bash 内建命令，相关帮助信息请使用help命令查看。help是另一个 bash 内建命令，只能显示内建命令的帮助信息（外部命令需用man或info）。常用选项包括：-d（简要描述）、-m（man 手册格式）、-s（仅输出命令格式）。例如help shopt会直接输出shopt的完整用法（详见 command/help.md）。

2. 被禁用的内建命令无法通过builtin调用。包括builtin自己——若builtin被enable -n builtin禁用，任何builtin调用都会报错。

3. builtin不是万能的命令执行器。它只识别内建命令；传入外部命令名或 shell 关键字（如for）不会执行，而是返回失败。

4. 脚本中谨慎定义同名函数。source方式执行的 bash 脚本若定义了与内建命令同名的函数，会改变脚本内部及当前终端环境的命令解析行为；而通过sh调用或直接执行的脚本不受终端别名影响（详见 command/alias.md 的注意事项）。当函数与内建命令冲突时，builtin是可靠的"逃生通道"。

扩展阅读

• command/builtin.md：本文主题文档（命令语法、返回值与全部示例）
• command/enable.md：启用/禁用内建命令，改变命令优先级的关键工具
• command/type.md：用type -t验证命令类型与查找优先级
• command/command.md：与 builtin 功能相近的command命令
• command/alias.md 与 command/unalias.md：别名的定义、持久化与删除
• command/help.md：获取 bash 内建命令帮助信息的方法

• 文档
• 教程