Ruby应用打包遇权限错误，如何配置自定义Gem缓存路径？

核心方案：配置本地Gem缓存与安装路径 #

要实现类似Node.js node_modules的本地依赖管理，无需root权限，可通过以下几种方式配置：

1. 临时单项目配置（单次生效） #

在项目目录下执行命令时直接指定缓存和安装路径：

• 下载依赖到本地缓存并打包：

  bundle package --cache-path ./vendor/bundle/cache
  

• 从本地缓存安装依赖到项目本地：

  bundle install --path ./vendor/bundle --local
  

  注：--path指定依赖安装到项目内的vendor/bundle目录，--cache-path指定Gem缓存的本地目录。

2. 永久单项目配置（写入项目配置） #

在项目目录下创建或修改.bundle/config文件，添加以下内容：

BUNDLE_PATH: "./vendor/bundle"
BUNDLE_CACHE_PATH: "./vendor/bundle/cache"

之后执行bundle package或bundle install时，会自动使用这些本地路径，无需每次加参数。

3. 全局用户配置（所有项目生效） #

如果希望所有Ruby项目都默认使用本地缓存，修改用户目录下的~/.bundle/config文件，添加：

BUNDLE_PATH: "~/.local/share/bundle"
BUNDLE_CACHE_PATH: "~/.local/share/bundle/cache"

这个路径位于用户目录下，无需root权限即可读写。

验证配置是否生效 #

执行bundle config命令，查看输出中的path和cache_path是否为你设置的路径，确认配置生效。

错误原因回顾：默认情况下Bundler会尝试写入系统级Gem目录（/opt/ruby/lib/ruby/gems/3.3.0/cache），该目录需要root权限，而你移除了用户对该路径的权限，因此触发Bundler::PermissionError。通过上述配置将缓存和依赖路径转移到用户可控的本地目录，即可解决权限问题。

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