Ruby Bundler多依赖文件分层管理及加载异常问题咨询

一、实现类似Python requirements的依赖拆分逻辑 #

别用gemspec管理项目依赖——那是给Ruby gem包做元数据定义用的，项目依赖拆分还是得靠Gemfile，和Python的requirements思路一致：

• 根目录创建Gemfile.common，存放所有项目共用的gem
• 子目录（比如tools/install/）分别创建Gemfile.app（Ruby应用专属依赖）、Gemfile.lib（Ruby模块专属依赖）、Gemfile.project（当前项目独有依赖）
• 根目录主Gemfile可通过eval_gemfile批量引入，也可以单独指定某一个Gemfile执行安装：

  # 根目录Gemfile示例：按需组合引入依赖
  eval_gemfile "Gemfile.common"
  eval_gemfile "tools/install/Gemfile.app"
  

二、解决子目录依赖安装的权限错误 #

你遇到的权限问题，本质是执行命令时没读到根目录的.bundle/config——Bundler会从当前工作目录向上查找.bundle配置文件。正确做法是：不要cd到子目录执行命令，直接在项目根目录运行：

# 根目录下执行，指定子目录的Gemfile路径
bundle install --gemfile=tools/install/Gemfile.app

这样Bundler会自动加载根目录.bundle/config里的BUNDLE_PATH: "venv"配置，不会往系统gem目录（/var/lib/gems/3.2.0/）写入文件，自然就不会触发权限错误。

三、处理--path警告与lock文件分散问题 #

1. --path弃用警告：Bundler 2.6确实没正式标记--path弃用，但官方更推荐用.bundle/config里的BUNDLE_PATH配置替代命令行参数——你根目录已经配置好了该参数，完全不需要再加--path参数，直接在根目录执行命令即可。
2. lock文件分散问题：默认每个Gemfile会生成对应的lock文件，如果你想统一用根目录的Gemfile.lock，可以用--lockfile参数指定：

bundle install --gemfile=tools/install/Gemfile.app --lockfile=Gemfile.lock

这样所有依赖都会合并到根目录的lock文件里，不会在子目录生成新的.bundle和lock文件。

四、额外优化思路 #

如果需要针对不同场景安装不同依赖组，也可以在同一个Gemfile里用group块划分，比如：

# Gemfile.common
gem "rails", "~> 7.0"

group :app do
  gem "puma"
end

group :lib do
  gem "rspec"
end

然后用bundle install --without lib来排除不需要的组，这种方式也能实现依赖拆分，可根据个人习惯选择。

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