Bashrc 非交互 Shell 跳过 PATH 配置导致命令找不到

问题现象

终端里可以正常使用 bun：

bun --version

但在脚本、自动化工具或 bash -c 这类非交互命令环境中，可能会报：

bun: command not found

这类问题容易误判成“工具没有安装”。实际情况可能是工具已经安装，只是当前 shell 没有加载到对应的 PATH。

很多 Debian/Ubuntu 风格的 ~/.bashrc 顶部都有类似逻辑：

# If not running interactively, don't do anything
case $- in
    *i*) ;;
      *) return;;
esac

$- 是 Bash 当前启用的选项集合。如果里面包含 i，说明当前 shell 是交互式 shell，也就是用户打开终端手动输入命令的场景。

如果不包含 i，说明当前 shell 是非交互式 shell，例如：

bash -c 'command -v bun'

这种情况下 .bashrc 会直接 return，后面的内容不会继续执行。

如果 Bun 安装脚本把环境变量追加在 .bashrc 末尾：

export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

那么交互式终端可以正常用 bun，但非交互 shell 会在前面的 return 处提前退出，导致 ~/.bun/bin 没有进入 PATH。

先看当前非交互环境能否找到 bun：

command -v bun
bun --version
printf 'PATH=%s\n' "$PATH"

再显式模拟交互式 Bash：

bash -ic 'command -v bun; bun --version; printf "PATH=%s\n" "$PATH"'

如果第二个命令能找到 bun，第一个找不到，基本就能确认是交互和非交互 shell 加载路径不同。

还可以检查 ~/.bashrc 中相关配置的位置：

grep -nE 'case \$-|return|BUN_INSTALL|\.bun|PATH' ~/.bashrc

重点看 Bun 的 PATH 配置是否位于非交互检查之后。

安装脚本通常只做保守追加，不会重构用户的 shell 配置文件。原因是 .bashrc 没有统一结构，自动插入到某个 return 前面有误改风险。

对安装脚本来说，最常见目标是“重新打开终端后能用”。交互式终端不会被上面的 return 拦住，所以追加到 .bashrc 末尾通常可以满足普通使用。

但脚本、CI、自动化工具、编辑器任务和代理执行器经常运行在非交互 shell 中。它们不一定会执行完整的 .bashrc，因此通用工具链的 PATH 最好不要只依赖 .bashrc 末尾。

“终端能用，自动化命令找不到”不一定是安装失败，而可能是 shell 启动模式不同。

排查时先确认三件事：