使用rbenv时ruby-lsp执行失败求助

问题分析 #

你当前使用rbenv管理Ruby版本（当前激活3.1.4），已成功安装ruby-lsp且gem list能查到，但执行ruby-lsp时提示命令仅存在于3.2.2版本，核心原因大概率是：

• rbenv的shim文件未同步更新，无法识别当前版本下的ruby-lsp命令
• 安装过程中因依赖gem（如debug）未正确构建，导致ruby-lsp的可执行文件未生成到当前版本的bin目录

解决方案 #

1. 验证当前Ruby版本的gem安装路径 #

先确认ruby-lsp的可执行文件是否存在于当前3.1.4版本的gem bin目录：

# 查看当前Ruby的gem根目录
gem environment gemdir
# 检查该目录下的bin文件夹是否有ruby-lsp
ls $(gem environment gemdir)/bin/ruby-lsp

如果输出No such file or directory，说明可执行文件未生成，需重新安装。

2. 修复依赖gem并重新安装ruby-lsp #

安装时提示Ignoring debug-1.7.2 because its extensions are not built，先修复这个依赖：

gem pristine debug --version 1.7.2
# 强制重新安装ruby-lsp到当前版本
gem install ruby-lsp --force

3. 强制更新rbenv shims #

rbenv通过shims目录管理命令映射，重新生成shim确保系统能识别当前版本的ruby-lsp：

rbenv rehash --verbose

执行后再尝试运行ruby-lsp。

4. 确认PATH环境变量优先级 #

确保rbenv的shims目录在PATH最前端，避免系统优先调用其他版本的命令：

echo $PATH

输出需以/Users/myuser/.rbenv/shims开头，若不是，需检查shell配置文件（如.zshrc/.bashrc）中rbenv的初始化代码是否正确，确保以下代码在配置文件中：

eval "$(rbenv init -)"

修改后重启shell生效。

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