Dockerfile中含方括号的RUN命令执行失败，求转义方案

问题根源 #

命令执行失败主要有两个核心原因：

1. 语法格式混淆：若误将Docker的exec格式（RUN ["command", "args"]）与shell语法混用，&&、变量替换$NVM_DIR这类shell特性无法被exec格式解析，直接导致语法失效。
2. 前置条件不满足：[ -s "$NVM_DIR/nvm.sh" ]返回false，说明$NVM_DIR未正确定义，或nvm.sh文件不存在/为空，触发退出码1。

修复方案 #

方案1：使用shell格式的RUN命令（推荐） #

保留shell原生语法，去掉多余转义与错误格式：

# 先显式设置NVM_DIR（默认路径为/root/.nvm，可根据实际安装路径调整）
ENV NVM_DIR /root/.nvm
# 执行source命令，无需转义.
RUN [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

若想避免文件不存在时的构建失败，可改用条件判断：

RUN if [ -s "$NVM_DIR/nvm.sh" ]; then . "$NVM_DIR/nvm.sh"; fi

方案2：确保nvm正确安装 #

如果是nvm未安装导致文件缺失，需先完成安装步骤：

# 安装指定版本的nvm
RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 设置环境变量
ENV NVM_DIR /root/.nvm
# 加载nvm
RUN [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

方案3：使用exec格式（仅作参考） #

若必须用exec格式，需通过sh -c包裹整个命令串，注意转义双引号：

RUN ["sh", "-c", "[ -s \"$NVM_DIR/nvm.sh\" ] && . \"$NVM_DIR/nvm.sh\""]

额外提示 #

Docker中每个RUN是独立shell进程，当前RUN加载的nvm环境不会自动传递给后续RUN，可通过两种方式解决：

• 在同一个RUN中串联后续命令：

  RUN [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" && nvm install 20
  

• 将加载逻辑写入shell配置文件，后续通过bash -c执行命令：

  RUN echo "[ -s \"$NVM_DIR/nvm.sh\" ] && . \"$NVM_DIR/nvm.sh\"" >> ~/.bashrc
  RUN bash -c "nvm install 20"
  

内容的提问来源于stack exchange，提问作者Kamil1014