ROR：如何将RubyGems更新至指定版本？bundle update仍更新最新版

操作失效的核心原因 #

• bundle update <gem名> 的默认执行逻辑，是拉取当前Gemfile版本声明允许范围内的最高兼容版本，本身不会主动识别命令行附带的自定义版本参数
• bundle update 命令本身不支持通过 -v "x.x.x" 参数指定更新目标版本，这是追加版本参数后依然自动拉取最新版的核心原因

标准操作流程 #

• 编辑项目根目录下的Gemfile，找到对应gem的声明行，显式写入需要锁定的目标版本，示例格式：

# 示例：将rails gem锁定到7.1.3.2版本
gem 'rails', '7.1.3.2'

注意：如果原Gemfile中对应gem写了宽松版本规则（比如~> 7.1、>= 7.1），必须替换为需要的精确目标版本声明，否则bundle依然会拉取该规则下的最高版本。

• 在项目根目录执行更新命令，让bundle按照Gemfile的版本声明重新解析依赖、同步更新Gemfile.lock：

bundle update <目标gem名称>

此时因为Gemfile已经明确写死了目标版本，bundle不会自动拉取超出声明范围的更高版本。

异常排查与注意事项 #

• 如果执行后依然解析出高于目标值的版本，优先检查项目内其他gem的声明、或者项目本身的.gemspec文件中的依赖规则，是否存在强制要求该gem必须升级到更高版本的约束，同步调整对应约束即可。
• 禁止手动直接修改Gemfile.lock中对应的gem版本号，这类手动修改的内容会在下次执行bundle install时被依赖解析流程自动覆盖，无法实现长期锁定版本的效果。
• 如果本地gem源缓存存在版本偏移问题，可以追加--full-index参数强制拉取远端源的全量版本列表完成解析：

bundle update <目标gem名称> --full-index

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