macOS Sequoia 15.3 M3 Pro芯片 iOS 开发环境配置记录（最新）

进行如下工作之前首先确保终端已翻墙，在ClashX选择“复制终端代理命令”，在终端进行粘附并执行。

安装 homebrew

Homebrew 是 Mac 平台的一个包管理工具，提供了许多Mac下没有的Linux工具等。

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

设置环境变量

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

这时候输入 brew -v 就可以看到版本输出了。

$ brew -v
Homebrew 4.2.4

安装rbenv

‌rbenv‌是一个轻量级的Ruby版本管理工具，它允许开发者在同一台计算机上安装、切换和管理多个Ruby版本，而不会干扰系统自带的Ruby环境。rbenv通过修改环境变量来控制当前使用的Ruby版本，提供隔离的Ruby运行环境，确保项目的兼容性和运行稳定性‌。

brew install rbenv 
rbenv init

rbenv 通过修改环境变量控制版本，若 Shell 初始化脚本（如 ~/.bashrc 或 ~/.zshrc ）未加载 rbenv，会导致切换失效。

# 检查 Shell 配置是否包含以下内容 
grep 'eval "$(rbenv init -)"' ~/.bashrc ~/.zshrc 
# 若无输出，手动添加并加载配置 
echo 'eval "$(rbenv init -)"' >> ~/.zshrc  # 根据实际 Shell 类型调整 
source ~/.zshrc

注意安装rbenv则不能安装rvm，否则会出现与其他 Ruby 管理工具冲突导致后续ruby安装失败。如果已安装 rvm，应执行 rvm implode。

安装ruby

rbenv install --list # 查看可用ruby版本
rbenv install 3.2.2 # 安装执行版本 
rbenv global 3.2.2 # 设为默认版本
rbenv rehash # 重新加载环境变量

执行 ruby -v 进行验证，此时应输出 “ruby 3.2.2”。

安装 cocoaPods

如果之前已安装其他版本的cocoapods，应先卸载旧版本。

gem list --local | grep cocoapods # 查看目前 gem 中安装的所有 cocoapods 组件
sudo gem uninstall * # 对这些组件一一执行卸载，*替换为上一个命令输出的组件名

安装指定版本的 cocoaPods（末尾参数 -V 可以看到具体安装进度）。

sudo gem install cocoapods -v 1.14.3 -V

执行 pod --version 验证安装。

安装fastlane

确保 Xcode 命令行工具已安装 xcode-select --install，若已安装会提示无需更新。
通过 RubyGem 安装：

sudo gem install fastlane -NV

通过 fastlane --version 验证安装。