使用GitHub Desktop切换分支时PATH重置致Ruby版本变更的原因排查

问题原因 #

• GitHub Desktop作为GUI应用，启动时不会加载终端shell的配置文件（如~/.zshrc、~/.bashrc），默认使用系统原生的PATH环境变量。切换分支时，它会重新初始化进程环境，直接覆盖你在终端中手动配置的带rbenv路径的PATH，导致rbenv相关路径被移除，系统只能找到预装的默认Ruby 2.6版本。
• 你手动执行的export PATH="$HOME/.rbenv/bin:$PATH"和eval "$(rbenv init -)"仅对当前终端会话生效，GitHub Desktop的独立进程无法共享终端的环境变量配置。

解决办法 #

• 配置GUI应用可读取的环境变量文件
  macOS下，GUI应用会读取~/.zprofile（zsh）或~/.bash_profile（bash）中的环境变量配置。将rbenv的初始化代码写入该文件：

  export PATH="$HOME/.rbenv/bin:$PATH"
  eval "$(rbenv init -)"
  

  保存后重启GitHub Desktop，后续切换分支时PATH就会自动包含rbenv路径，Ruby版本也会保持为3.2.1。

• 给项目绑定本地Ruby版本
  在项目根目录执行以下命令，生成.ruby-version文件：

  rbenv local 3.2.1
  

  这个文件会指定当前项目使用的Ruby版本，即使PATH出现小问题，只要rbenv能被系统找到，就会自动加载对应版本。结合上一种方法使用，效果更稳定。

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