Dockerfile中使用rbenv安装Ruby后出现gem command not found错误

问题根源 #

Docker的每个RUN指令都是独立的bash进程，默认不会自动加载~/.bashrc，因此你添加的eval "$(rbenv init - bash)"无法在后续RUN命令中生效；另外直接设置PATH时，可能因shell环境未完成rbenv初始化、路径优先级问题，导致系统找不到rbenv管理的gem命令。

修正方案 #

方案1：在执行gem命令前手动初始化rbenv

将rbenv初始化与gem安装放在同一个RUN中，确保共享同一shell环境：

RUN brew install rbenv ruby-build
RUN echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc
RUN rbenv install 3.2.2
RUN rbenv global 3.2.2
RUN eval "$(rbenv init - bash)" && gem install bundler

方案2：直接添加rbenv shim路径到PATH

rbenv通过shim目录管理Ruby版本，将该目录加入PATH优先级最高，确保调用rbenv管控的gem：

RUN brew install rbenv ruby-build
RUN rbenv install 3.2.2
RUN rbenv global 3.2.2
ENV PATH="/root/.rbenv/shims:/root/.rbenv/versions/3.2.2/bin:$PATH"
RUN gem install bundler

方案3：使用登录shell加载bashrc

通过bash -l -c启动登录shell，自动读取~/.bashrc中的rbenv初始化配置：

RUN brew install rbenv ruby-build
RUN echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc
RUN rbenv install 3.2.2
RUN rbenv global 3.2.2
RUN bash -l -c "gem install bundler"

额外优化建议 #

尽量合并相关RUN指令，减少镜像层数的同时保证环境一致性：

RUN brew install rbenv ruby-build \
    && echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc \
    && eval "$(rbenv init - bash)" \
    && rbenv install 3.2.2 \
    && rbenv global 3.2.2 \
    && gem install bundler

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