Fastlane在MacOS Ventura 13.1（M1）环境下无法运行的解决咨询

报错核心原因是系统自带的Ruby环境（2.6.0）中未安装fastlane，或已安装的fastlane未被终端识别；且M1芯片Mac的系统Ruby存在权限限制，不适合直接安装第三方gem。以下是几种可行的解决方法：

方法1：通过Homebrew安装（推荐） #

Homebrew会为M1芯片配置独立环境，避开系统Ruby的权限问题：

• 若未安装Homebrew，先执行安装命令：

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

• 安装fastlane：

  brew install fastlane
  

• 验证安装成功：

  fastlane --version
  

方法2：使用Ruby版本管理器安装 #

通过rbenv或rvm管理独立Ruby环境，彻底脱离系统Ruby的限制：

以rbenv为例： #

1. 安装rbenv：

   brew install rbenv
   

2. 将rbenv初始化添加到shell配置文件（zsh用户修改~/.zshrc，bash用户修改~/.bash_profile）：

   echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
   

3. 重启终端或刷新配置：

   source ~/.zshrc
   

4. 安装兼容的Ruby版本（如3.2.2）：

   rbenv install 3.2.2
   

5. 设置全局Ruby版本：

   rbenv global 3.2.2
   

6. 安装fastlane：

   gem install fastlane
   

7. 验证安装：

   fastlane --version
   

方法3：修复现有fastlane路径问题 #

如果之前已安装fastlane但终端无法识别，可手动配置PATH：

1. 查看gem的安装目录：

   gem environment gemdir
   

2. 将该目录下的bin文件夹添加到环境变量（以zsh为例）：

   echo 'export PATH="$(gem environment gemdir)/bin:$PATH"' >> ~/.zshrc
   

3. 刷新配置：

   source ~/.zshrc
   

4. 再次执行fastlane命令测试

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