在 Docker 构建过程中执行 gvm install 时出现 /bin/sh: 1: gvm: not found，本质是 Shell 环境不匹配导致 GVM 初始化脚本未加载——Docker 默认使用 /bin/sh（非交互式），而 GVM 依赖 Bash 环境及显式 source 其脚本才能注册命令。
在 docker 构建过程中执行 `gvm install` 时出现 `/bin/sh: 1: gvm: not found`，本质是 shell 环境不匹配导致 gvm 初始化脚本未加载——docker 默认使用 `/bin/sh`（非交互式），而 gvm 依赖 bash 环境及显式 source 其脚本才能注册命令。
GVM（Go Version Manager）是一个用于管理多个 Go 版本的工具，其设计初衷面向交互式 Bash 终端：安装后会自动将初始化代码写入 ~/.bashrc 或 ~/.bash_profile，并在每次启动新 Bash 会话时通过 source 加载 gvm 函数和命令。然而，Docker 的 RUN 指令默认使用 /bin/sh 执行命令，且为非登录、非交互式 Shell，既不会读取 ~/.bashrc，也无法自动识别 gvm 这一 shell 函数（它并非独立二进制，而是由脚本动态注入的函数）。这就是为什么你看到 /root/.gvm/bin/gvm 存在，但直接运行 gvm 却报 “not found”——因为该命令根本未被 shell 解析器加载。
✅ 正确解决方案：显式 source + 指定 Bash 解释器
你需要在每个调用 gvm 的 RUN 指令中，显式加载 GVM 的核心脚本，并确保使用 /bin/bash 执行。推荐写法如下：
FROM ubuntu:22.04
# 安装基础依赖
RUN apt-get update && apt-get install -y \
curl git mercurial make binutils bison gcc build-essential \
&& rm -rf /var/lib/apt/lists/*
# 安装 GVM（注意：使用 bash -c 并重定向 stderr 避免交互提示）
RUN /bin/bash -c "curl -sSL https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer | bash"
# 关键：显式 source GVM 脚本，并在同一个 bash 上下文中执行 gvm 命令
RUN /bin/bash -c "source /root/.gvm/scripts/gvm && gvm install go1.4 -B"
RUN /bin/bash -c "source /root/.gvm/scripts/gvm && gvm use go1.4"
RUN /bin/bash -c "source /root/.gvm/scripts/gvm && go version"? 为什么
source /root/.gvm/scripts/gvm是必须的？
该脚本定义了gvm函数、设置$GVM_ROOT、配置PATH，并加载版本管理逻辑。不 source 就等于没“激活”GVM。
⚠️ 注意事项与最佳实践
-
避免拆分 source 和 gvm 命令：以下写法 ❌ 错误：
RUN source /root/.gvm/scripts/gvm # 此 shell 退出后环境丢失 RUN gvm install go1.4 # 新 shell 中 gvm 仍未定义
因为每个
RUN指令都在独立的 shell 进程中运行，上一条指令的环境变量/函数不会延续到下一条。 -
推荐合并操作（提升构建效率与可维护性）：
将多步 GVM 操作封装为一个内联脚本或外部.sh文件：RUN /bin/bash -c ' set -e source /root/.gvm/scripts/gvm gvm install go1.4 -B gvm use go1.4 echo "✅ Go $(go version) ready." '
-
替代方案：直接使用官方 Go 镜像（生产推荐）
GVM 在容器中属于“开发期便利工具”，但增加了构建复杂度和不确定性。对于生产镜像，更推荐使用多阶段构建 + 官方golang:<version></version>基础镜像：FROM golang:1.21 AS builder WORKDIR /app COPY . . RUN go build -o myapp . FROM debian:slim COPY --from=builder /app/myapp /usr/local/bin/myapp CMD ["myapp"]
这样无需 GVM，体积更小、启动更快、行为更确定。
-
额外验证建议：
构建失败时，可通过交互式调试快速定位：docker build -t debug-gvm . && docker run -it --rm debug-gvm /bin/bash -c 'ls -l /root/.gvm/scripts/ && source /root/.gvm/scripts/gvm && type gvm'
综上，gvm: not found 不是安装失败，而是环境未就绪。核心原则只有一条：在每个需使用 gvm 的 RUN 中，用 /bin/bash -c 显式 source 其初始化脚本。遵循此模式，即可稳定完成 Go 多版本容器化构建。
