使用Bundler获取指定版本Gem包遇版本匹配问题求助

首先明确你遇到的核心逻辑：Bundler对Git源Gem的版本处理和rubygems官方源不同——它不会索引仓库所有历史版本，默认只会检查当前指定分支（通常是主分支）最新commit里的gemspec版本。

疑问1：是否遗漏了配置细节？ #

是的，你忽略了Git源Gem的版本识别规则：

• 推送0.14.1时，仓库主分支的gemspec版本是0.14.1，符合~>0.14.0的约束（允许0.14.x小版本更新），所以Bundler能正常匹配。
• 但推送0.15.0后，主分支的gemspec版本升级到0.15.0，超出了~>0.14.0的范围，Bundler会判定该仓库没有符合约束的版本，因此报错。

疑问2：如何指定版本并确保Bundler总能找到它？ #

有三种可靠方案：

1. 给每个版本打Git标签（推荐）

发布Gem版本时，给对应commit打上与版本号一致的标签（比如v0.14.0、v0.14.1、v0.15.0）。之后Gemfile可以这样写：

gem "custom-metrics", "~> 0.14.0", git: "https://gitlab.custom.co/gems/custom-metrics.git"

Bundler会自动扫描仓库所有标签，找到符合~>0.14.0约束的最高版本（比如v0.14.1）。后续发布0.14.2时，只要打上对应标签，Bundler就能自动识别更新。

如果想固定到具体小版本，也可以直接指定标签：

gem "custom-metrics", "0.14.1", git: "https://gitlab.custom.co/gems/custom-metrics.git", tag: "v0.14.1"

2. 使用版本分支

如果仓库按版本维护稳定分支（比如0-14-stable分支专门保留0.14.x系列的代码和gemspec），可以在Gemfile里指定该分支：

gem "custom-metrics", "~> 0.14.0", git: "https://gitlab.custom.co/gems/custom-metrics.git", branch: "0-14-stable"

这样Bundler会拉取该分支的最新commit，而该分支的gemspec始终保持在0.14.x范围内，不会被0.15.x版本影响。

3. 固定到具体commit的ref

这是你目前使用的方法，直接指定对应版本的commit哈希：

gem "custom-metrics", "~> 0.14.0", git: "https://gitlab.custom.co/gems/custom-metrics.git", ref: "abc123def"

这种方式最稳妥，但缺点是后续0.14.x的小版本更新需要手动查找并更新commit哈希。

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