安装rbenv后启动ReactJS服务报yarn命令未找到 清理shims无效

• 你的系统PATH环境变量中，~/.rbenv/shims目录的排序优先级远高于nvm、系统内置的yarn可执行文件所在目录，执行yarn命令时会优先匹配rbenv生成的shim文件
• 这个~/.rbenv/shims/yarn是之前误装yarnRuby gem时生成的无效残留：你之前执行的批量清理循环没有生效（当rbenv whence yarn找不到安装了yarn gem的Ruby版本时，循环体不会执行任何删除操作），即使已经卸载了对应gem，残留的shim文件也没有被清除，shim找不到对应的真实可执行文件，就会抛出rbenv: yarn: command not found的错误
• 从which -a yarn的输出重复出现4次rbenv路径的yarn，还能说明你在shell配置里重复把~/.rbenv/shims加进了PATH，进一步放大了无效shim的优先级影响，排在nvm自带yarn路径的前面

1. 彻底清除残留的无效yarn shim #

直接手动删除残留的shim文件，再刷新rbenv的shim列表即可：

rm -f ~/.rbenv/shims/yarn
rbenv rehash

2. 验证shim清理结果 #

重新执行which -a yarn检查输出，正常情况下排在最前面的路径应该是nvm对应的yarn可执行文件，示例输出：

/home/user/.nvm/versions/node/v14.8.0/bin/yarn
/usr/bin/yarn
/bin/yarn

如果依然能看到rbenv路径下的yarn shim残留，执行以下命令定位所有残留的shim文件并删除：

# 查找所有rbenv生成的yarn相关shim
find ~/.rbenv/shims -name "yarn" -exec rm -f {} \;
rbenv rehash

3. 排查PATH配置问题 #

如果清理完shim后执行yarn还是触发rbenv的报错，检查shell配置文件（如~/.zshrc、~/.bashrc、~/.bash_profile）的配置：

• 正常的加载顺序应该是先初始化rbenv，再初始化nvm。nvm加载时会自动把当前Node版本的bin目录加到PATH最前面，优先级高于rbenv的shims目录
• 参考正确的配置顺序示例：

  # 初始化rbenv
  export PATH="$HOME/.rbenv/bin:$PATH"
  eval "$(rbenv init -)"
  # 初始化nvm
  export NVM_DIR="$HOME/.nvm"
  [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  

• 额外检查shell配置里的PATH定义，不要重复添加~/.rbenv/shims路径，避免不必要的优先级干扰。可以执行echo $PATH查看输出，确认~/.rbenv/shims只出现一次。

4. 避免后续重复出现同类问题 #

可以把和Node生态工具重名的Ruby包对应的shim加入rbenv的禁用列表，防止误装同名Ruby包时生成的shim干扰正常工具调用：

# 写入禁用shim的工具列表
echo -e "yarn\nnpm\nnode" > ~/.rbenv/disabled-shims

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