Dockerfile 的 RUN 指令需显式调用 sh -c 或 bash -c 才能使用管道和逻辑运算符；Alpine 镜像默认 ash 不支持 bash 特性，应分层 RUN 提升可维护性与缓存效率。

Dockerfile 中的 RUN 指令本身不支持直接使用管道符（|）或逻辑运算符（如 &&、||）进行多步复合操作，因为默认 shell 是 /bin/sh -c，而 Alpine 等精简镜像甚至不带 bash。但可以通过显式调用 sh -c 或 bash -c 来启用完整 shell 功能，从而安全、可靠地组合命令。

必须显式调用 shell 才能使用管道和逻辑控制

直接写 RUN apt-get update | grep -q "Hit" || echo "failed" 会报错：sh 不识别管道右侧命令，或因 exit code 非零导致构建中断。正确写法是包裹在 sh -c 中：

• RUN sh -c 'apt-get update 2>&1 | grep -q "Hit" || { echo "Update failed"; exit 1; }'
• RUN sh -c 'curl -s https://example.com/version | grep -oE "[0-9]+\.[0-9]+\.[0-9]+" > /tmp/ver && chmod +x /tmp/ver'

注意：sh -c 后的整个字符串是一个参数，单引号避免宿主机提前解析变量；若需传参，可用双引号配合 \$1 占位（需转义）。

避免因中间命令失败导致意外跳过关键步骤

管道中任意命令出错不会自动终止后续执行（除非用 set -e），容易掩盖问题。推荐显式检查状态：

• 用 && 替代管道做条件串联：RUN sh -c 'wget -qO- https://... | tar -xzf - -C /app && chown -R app:app /app'
• 分步加错误捕获：RUN sh -c 'if ! output=\$(curl -sI https://api.example.com 2>/dev/null); then echo "API unreachable"; exit 1; fi; echo "\$output" | head -1 > /status'

不要依赖管道默认行为——Docker 构建只看最后一条命令的退出码。

处理多行复杂逻辑时优先拆分为多个 RUN（更可读、更易缓存）

虽然技术上可在单个 RUN sh -c '...' 中塞入几十行 shell 脚本，但这牺牲可维护性与 layer 缓存优势。例如安装依赖+编译+清理，应分层：

• RUN apt-get update && apt-get install -y build-essential curl
• RUN curl -sL https://get.rvm.io | bash -s stable
• RUN /bin/bash -l -c 'rvm install 3.1 && rvm use 3.1 --default'
• RUN rm -rf /var/lib/apt/lists/*

每层独立缓存，调试时也可快速跳过已成功步骤；只有当逻辑强耦合（如临时 token 必须在同进程内传递）才用单个 sh -c 多命令串。

Alpine 镜像需注意 busybox ash 的兼容性限制

Alpine 默认用 ash（busybox 实现），不支持 [[ ]]、source、数组等 bash 特性。管道可用，但高级语法会失败：

• ✅ 支持：ls /etc | grep -E "^(host|resolv)"
• ❌ 不支持：[[ \$(id -u) == "0" ]] && echo "root"（改用 [ \$(id -u) = "0" ]）
• ? 替代方案：加装 bash（apk add --no-cache bash），再用 bash -c

若坚持用 ash，优先查 ash 手册，避免照搬 bash 脚本。