一、安装 Homebrew
如果你尚未安装 Homebrew，可以在终端里运行下面的命令来安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
在执行上述命令时，你需要输入用户密码来授权安装，并且按照提示完成安装过程。
配置 Homebrew 路径
要是你已经安装了 Homebrew，但仍然遇到此错误，那可能是因为它的路径没有被正确添加到环境变量里。你可以按以下步骤来配置路径：
1. 打开 ~/.zshrc 文件
使用你偏好的文本编辑器打开 ~/.zshrc 文件，例如使用 nano 编辑器：
nano ~/.zshrc
2. 添加 Homebrew 路径
在 m芯片的 Mac 上，路径可能有所不同，你需要添加：
export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"
3. 保存并退出文件
在 nano 编辑器里，按 Ctrl + X，接着按 Y 确认保存，最后按 Enter 键退出。
4. 使配置生效
运行以下命令让新的配置生效：
source ~/.zshrc
验证安装
完成上述步骤之后，你可以在终端中运行以下命令来验证 Homebrew 是否已经正确安装并配置：
brew --version
若成功显示 Homebrew 的版本号，就表明安装和配置都已完成。
二、在 macOS (M4 CPU) 上安装 Ruby 3.4.2
推荐方法：使用 Homebrew 和 rbenv (最简单)
# 1. 确保 Homebrew 已更新
brew update
brew upgrade
# 2. 安装 rbenv 和 ruby-build
brew install rbenv
# 3. 将 rbenv 添加到 shell 配置
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc
# 4. 安装 Ruby 3.4.2 (会自动为 Apple Silicon 优化)
rbenv install 3.4.2
# 5. 设置为全局默认
rbenv global 3.4.2
# 6. 验证安装
ruby -v
手动编译安装方法 (高级用户)
# 1. 安装必要工具
brew install openssl readline libyaml gcc
# 2. 下载 Ruby 3.4.2
curl -O https://cache.ruby-lang.org/pub/ruby/3.4/ruby-3.4.2.tar.gz
tar xzf ruby-3.4.2.tar.gz
cd ruby-3.4.2
# 3. 为 Apple Silicon 配置 (M4 是 ARM64 架构)
./configure --prefix=/usr/local/ruby-3.4.2 \
--with-openssl-dir=$(brew --prefix openssl) \
--with-arch=arm64 \
--enable-shared \
--disable-install-doc
# 4. 编译安装 (使用所有核心)
make -j$(sysctl -n hw.ncpu)
sudo make install
# 5. 添加到 PATH
echo 'export PATH="/usr/local/ruby-3.4.2/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 6. 验证安装
ruby -v
解决常见问题
-
openssl 问题：
export LDFLAGS="-L$(brew --prefix openssl)/lib" export CPPFLAGS="-I$(brew --prefix openssl)/include" -
编译器问题：
export CC=/usr/bin/clang export CXX=/usr/bin/clang++ -
M4 芯片特定优化：
- 确保使用最新的 Xcode 命令行工具：
xcode-select --install
- 确保使用最新的 Xcode 命令行工具：
安装后配置
-
更新 gem：
gem update --system -
安装 Bundler：
gem install bundler -
设置 gem 本地路径：
echo 'export GEM_HOME="$HOME/.gem"' >> ~/.zshrc echo 'export PATH="$GEM_HOME/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
验证性能
# 检查是否为 ARM64 架构构建
file $(which ruby)
# 应该显示: Mach-O 64-bit executable arm64
# 运行基准测试 (可选)
ruby -e 'puts RubyVM::MJIT.enabled?'
对于 M4 芯片，Ruby 应该能自动检测并使用最优化的编译设置。如果遇到任何架构相关问题，可以在配置时明确指定：
./configure --build=arm64-apple-darwin23.0.0
三、 在 macOS (M4 芯片) 上安装 CocoaPods
由于 M4 是 Apple Silicon 的最新 ARM 架构芯片，安装 CocoaPods 需要特别注意 Ruby 环境和架构兼容性。以下是针对 M4 芯片的优化安装方法：
前提条件
-
确保已安装 Xcode 命令行工具：
xcode-select --install -
安装 CocoaPods：
sudo gem install -n /usr/local/bin cocoapods
初始化 CocoaPods
-
设置仓库（首次使用需要）：
pod setup（这个过程可能会比较久，因为要克隆整个 Specs 仓库）
-
验证安装：
pod --version
解决常见问题
1. 权限问题
# 如果遇到权限错误，可以尝试：
sudo chown -R $(whoami) /Library/Ruby/Gems/
# 或者完全避免使用 sudo
2. M4 芯片架构问题
# 确保 gem 是为 arm64 架构构建的
arch -arm64 gem install cocoapods
3. Xcode 路径问题
# 确保 Xcode 路径正确
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
4. 安装速度慢
# 可以更换 RubyGems 源
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
升级 CocoaPods
gem update cocoapods
卸载 CocoaPods
gem uninstall cocoapods
使用 CocoaPods
- 在项目目录中：
pod init
- 编辑 Podfile 后：
pod install
- 以后更新依赖：
pod update
注意事项
对于 M4 芯片，所有安装命令都会自动以 ARM64 架构运行，无需特别配置
-
如果遇到任何架构兼容性问题，可以在命令前加上：
arch -arm64 [你的命令] 建议使用 rbenv 管理 Ruby 环境，可以避免很多权限和兼容性问题
-
如果使用系统 Ruby，建议定期运行：
sudo gem update --system sudo gem cleanup
