非root用户在Dev Container中安装Ruby LSP扩展的方法

核心原因 #

非root用户无权限写入系统级的/usr/local/bundle目录，Ruby LSP扩展默认尝试使用该路径存储依赖，触发权限报错。

解决方法 #

1. 配置Bundle使用用户级目录（推荐） #

将Ruby依赖安装到当前用户的私有目录，彻底避开系统路径的权限限制：

• 执行命令设置Bundle默认路径：

  bundle config set path '~/.bundle'
  

• 重新安装项目依赖：

  bundle install
  

• 让Ruby LSP识别该路径：在.devcontainer/devcontainer.json的settings字段中添加配置：

  "settings": {
    "rubyLsp.bundlePath": "${home}/.bundle"
  }
  

2. 调整Dev Container的目录权限 #

通过容器启动后的命令修正系统bundle目录权限，临时解决问题：
在.devcontainer/devcontainer.json中添加：

"postCreateCommand": "sudo chown -R $(whoami):$(whoami) /usr/local/bundle || true"

若要从根源避免，可在Dockerfile中提前创建非root用户并设置环境变量：

RUN useradd -m appuser
USER appuser
ENV BUNDLE_PATH=/home/appuser/.bundle

3. 强制Ruby LSP使用项目本地依赖 #

如果项目已通过bundle install --path vendor/bundle将依赖安装到项目目录，需让Ruby LSP指向该路径：
在VS Code设置（或devcontainer配置）中修改：

"rubyLsp.bundlePath": "${workspaceFolder}/vendor/bundle"

为什么预先在Gemfile添加依赖仍报错？ #

Ruby LSP扩展默认可能尝试全局安装或使用系统级bundle路径，而非项目已安装的本地依赖目录，因此即使Gemfile依赖安装完成，扩展仍会因权限问题无法写入系统目录。

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