Docker(GitHub Codespace)安装asdf ruby插件报Permission denied错误

• 直接执行$HOME/.bashrc的逻辑本身错误：.bashrc是交互shell启动时读取的文本配置文件，默认没有可执行权限，把它当作可执行命令运行必然触发Permission denied错误；加sudo运行时，系统会把它当作可执行程序查找，自然返回command not found。
• Docker构建阶段的RUN指令默认使用非交互模式的/bin/sh执行，不会自动加载.bashrc、.profile这类用户环境配置，因此asdf命令所在路径不会被自动加入环境变量，就算配置写入了bashrc，构建阶段也识别不到asdf命令。
• 尝试切vscode用户执行/root下的.bashrc时，普通用户默认无权限读取/root目录下的文件，因此触发权限报错。

核心调整逻辑 #

不要在构建阶段尝试加载整个.bashrc，直接source asdf的核心启动脚本加载路径，同时指定RUN指令使用bash执行，兼容asdf的脚本语法，提前安装Ruby源码编译依赖避免安装失败。

可直接复用的Dockerfile配置 #

# 提前定义要安装的Ruby版本参数，可按需修改
ARG RUBY_VERSION=3.3.5

# 第一部分：asdf核心安装（原有逻辑无需修改，若使用非root用户请先切换对应用户）
RUN git clone --depth 1 https://github.com/asdf-vm/asdf.git $HOME/.asdf && \
    echo '. $HOME/.asdf/asdf.sh' >> $HOME/.bashrc && \
    echo '. $HOME/.asdf/completions/asdf.bash' >> $HOME/.bashrc && \
    echo '. $HOME/.asdf/asdf.sh' >> $HOME/.profile

# 指定构建阶段RUN默认使用bash执行，避免dash/sh的语法兼容问题
SHELL ["/bin/bash", "-c"]

# 第二部分：安装asdf ruby插件及对应Ruby版本
RUN source $HOME/.asdf/asdf.sh && \
    # 安装Ruby源码编译依赖（适用于Ubuntu/Debian基镜像，其他发行版请替换对应包名）
    apt-get update && apt-get install -y --no-install-recommends \
        autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev \
        zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libdb-dev uuid-dev && \
    rm -rf /var/lib/apt/lists/* && \
    # 安装ruby插件
    asdf plugin add ruby https://github.com/asdf-vm/asdf-ruby.git && \
    # 安装指定版本Ruby
    asdf install ruby $RUBY_VERSION && \
    # 设置全局默认Ruby版本
    asdf global ruby $RUBY_VERSION && \
    # 可选：软链shim到全局bin路径，避免非交互shell找不到ruby/gem命令
    ln -sf $HOME/.asdf/shims/ruby /usr/local/bin/ruby && \
    ln -sf $HOME/.asdf/shims/gem /usr/local/bin/gem

针对GitHub Codespace的额外注意事项 #

• Codespace默认使用vscode非root用户运行，不要在root用户下安装asdf和插件后再切vscode用户，会出现目录权限问题。建议安装asdf前先切换到vscode用户，指定HOME为vscode的家目录：

  ARG USERNAME=vscode
  USER $USERNAME
  ENV HOME=/home/$USERNAME
  # 后续再执行asdf安装、插件安装的逻辑
  

• 如果你使用docker-compose配合devcontainer.json，不要把asdf的安装目录.asdf挂载到volume覆盖，否则构建阶段安装的插件和Ruby版本会被卷内容清空。

构建完成进入Codespace终端后，直接执行ruby -v可返回安装的对应版本号，执行asdf plugin list可看到ruby插件已在列表中，无需手动执行source加载配置。

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