Mac终端(eval):18: parse error near PATH报错排查（RVM/rbenv）

• 运行环境：Mac Monterey 12.4
• 故障现象：打开终端时抛出报错 (eval):18: parse error near 'PATH=/usr/local/opt/...'
• 前置操作梳理：
  • 此前曾安装RVM，尝试安装Ruby 2.6.1失败，确认RVM在Mac设备上安装旧版本Ruby存在兼容问题后，执行rvm implode命令卸载RVM，曾手动删除~/.bash_profile中部分RVM配置行，后续改装rbenv作为Ruby版本管理工具，rbenv本身功能可正常使用
  • 报错后执行echo $PATH查看环境变量，发现路径中残留/Users/francoortega/.rvm/bin，逐一打开shell配置文件排查，定位到三处配置异常：
    1. ~/.bash_profile残留RVM加载配置，且RVM配置行末尾未换行，直接与rbenv初始化语句连写，异常配置片段：

[[ -s "$HOME/.profile" ]] && source "$HOME/.profile" # Load the default .profile

[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm" # Load RVM into a shell session *as a function*eval "$(rbenv init -)"

2. `~/.bashrc`残留RVM路径添加配置：

# Add RVM to PATH for scripting. Make sure this is the last PATH variable change.
export PATH="$PATH:$HOME/.rvm/bin"

3. `~/.zshrc`既残留RVM路径添加配置，又存在语句连写问题：`eval "$(rbenv init - zsh)"`与后续自定义Ruby PATH配置行未换行直接拼接，异常配置片段：

# Add RVM to PATH for scripting. Make sure this is the last PATH variable change.
export PATH="$PATH:$HOME/.rvm/bin"

eval "$(rbenv init - zsh)"export PATH="/usr/local/opt/ruby/bin:/usr/local/lib/ruby/gems/2.6.10/bin:$PATH"

• 自行排查时曾尝试删除RVM相关配置但未清理完全，删除rbenv相关文件后报错消失，但需要保留rbenv的正常使用，因此提出三个核心疑问。

1. 保留rbenv前提下修复终端解析报错的操作方法 #

本次报错的核心诱因是配置文件中两条独立shell语句未做换行分隔，被shell识别为单条非法命令，和rbenv本身的文件没有关系，按以下步骤操作即可修复，不会影响rbenv功能：

1. 打开三个shell配置文件，先修正所有语句连写问题：
   • 编辑~/.bash_profile，在RVM配置行的末尾、eval "$(rbenv init -)"前插入换行，保证rbenv初始化语句单独占一行
   • 编辑~/.zshrc，在eval "$(rbenv init - zsh)"的末尾、自定义Ruby PATH的export语句前插入换行，保证PATH配置语句单独占一行
2. 按第三个问题的要求清理完所有RVM残留配置后保存文件，执行配置重载命令让修改立即生效（Mac Monterey默认使用zsh，优先执行第一条命令即可）：

source ~/.zshrc
# 若使用bash作为默认shell，再执行以下两条
source ~/.bash_profile
source ~/.bashrc

3. 完全退出终端后重新打开，即可验证报错消失，rbenv可正常使用。

2. 报错信息中/usr/local/opt/路径无法找到的原因 #

这个报错不是对应路径真的不存在，是shell语法解析失败抛出的连带提示：
~/.zshrc中rbenv初始化语句和后面的export PATH语句连写后，shell会把整段拼接后的内容当成eval函数的传入参数，不会将后面的export识别为独立命令，解析到PATH=/usr/local/opt/这段字符时，不符合eval的语法规则，就会抛出parse error，同时把解析失败位置附近的PATH=/usr/local/opt/...片段打印到报错信息中。只要把连写的语句拆分为独立两行，这个解析报错就会直接消失，不需要单独处理/usr/local/opt/路径。

3. RVM卸载完成后是否需要删除所有配置文件中的RVM相关行 #

必须全部删除。
rvm implode命令只会删除RVM自身的安装目录文件，不会自动清理各个shell配置文件中写入的RVM加载、PATH添加语句。残留的RVM配置行会带来两个明确问题：

• 每次启动终端时，shell都会尝试加载不存在的RVM脚本、将已经删除的.rvm/bin无效路径加入PATH，拖慢终端启动速度，同时污染环境变量
• 残留配置很容易和后续安装的rbenv等其他版本管理工具的配置产生冲突，本次遇到的语句连写、后续可能出现的Ruby版本优先级异常等问题，出现概率会大幅提升。
  需要删除的内容包括三个配置文件中所有提到.rvm的行：RVM加载的source语句、添加.rvm/bin到PATH的export语句、对应的RVM专属注释，删除后不会对系统运行和rbenv功能产生任何负面影响。

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