Rails 3.2项目Capistrano部署报错：bundler无法加载cap命令

我来帮你搞定这个部署报错的问题——本质原因是Bundler执行cap命令时，没有优先使用rbenv shims目录下的版本，反而去了ruby版本目录/.rbenv/versions/2.0.0-p353/bin/cap找，而这个路径里的cap可能不存在或者不是正确的可执行文件。下面是具体的解决步骤：

方案1：在deploy.rb中配置默认环境变量 #

直接在你的deploy.rb里添加环境变量设置，把rbenv shims路径放到PATH的最前面，确保系统优先找到shims里的cap：

# 放在deploy.rb的开头或者现有配置之后
set :default_environment, {
  'PATH' => "/.rbenv/shims:/.rbenv/bin:$PATH"
}

这个配置会让Capistrano在执行所有部署命令时，都使用正确的rbenv环境路径，Bundler也就会找到/.rbenv/shims/cap了。

方案2：添加rbenv初始化任务（可选补充） #

如果方案1还没解决，你可以在deploy.rb里添加一个前置任务，确保部署前先加载rbenv的环境：

# 在deploy.rb中添加
before 'deploy', 'rbenv:setup'

namespace :rbenv do
  task :setup do
    run 'export PATH="/.rbenv/shims:/.rbenv/bin:$PATH"'
  end
end

这个任务会在部署开始前，在服务器上手动设置PATH，强制让shims路径优先。

临时测试方案（本地执行） #

如果你想先临时验证一下，可以在本地执行部署命令前，先手动设置PATH：

export PATH="/.rbenv/shims:$PATH"
bundle exec cap deploy

如果这个能成功，说明就是环境变量的问题，直接用方案1的配置永久解决即可。

额外检查点 #

• 确认服务器上的/.rbenv/shims/cap确实存在且有执行权限，可以登录服务器执行ls -l /.rbenv/shims/cap查看。
• 确保你的本地环境和服务器环境的rbenv配置一致，避免版本差异导致的路径问题。

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