使用Capistrano 3.16.0时cap命令无法找到的问题求助

1. 定位Capistrano命令的实际路径 #

先执行以下命令找到gem可执行文件的存放目录：

gem environment | grep "EXECUTABLE DIRECTORY"

M1 Mac上常见的路径是 /opt/homebrew/lib/ruby/gems/x.x.x/bin（x.x.x对应你的Ruby版本），如果用rbenv/rvm这类版本管理工具，路径可能是 ~/.rbenv/shims 或 ~/.rvm/gems/ruby-x.x.x/bin。

也可以直接定位cap命令的具体位置：

find $(gem environment | grep -oP 'EXECUTABLE DIRECTORY: \K.*') -name cap

2. 检查当前bash的PATH配置 #

执行命令查看PATH里是否包含上述gem bin目录：

echo $PATH

3. 临时修复（立即生效） #

如果gem bin目录不在PATH里，执行以下命令添加（替换成你找到的实际路径）：

export PATH="/opt/homebrew/lib/ruby/gems/3.2.0/bin:$PATH"

之后测试cap -v，确认命令可正常调用。

4. 永久修复（重启终端仍生效） #

编辑bash的配置文件（M1 Mac通常是~/.bash_profile或~/.bashrc）：

nano ~/.bash_profile

在文件末尾添加一行（自动获取gem bin目录，无需手动写死路径）：

export PATH="$(gem environment | grep -oP 'EXECUTABLE DIRECTORY: \K.*'):$PATH"

保存退出后，执行以下命令让配置立即生效：

source ~/.bash_profile

重启终端后，cap命令即可正常使用。

5. 替代方案：用bundle exec执行 #

如果是通过bundle install安装的Capistrano，也可以直接用bundle调用命令，绕过路径问题：

bundle exec cap <你的命令>

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