M1 Mac执行npx react-native@latest init时Ruby Gems安装失败

安全阿岳

2026-7-6

解决M1 Mac上React Native CLI创建应用时Ruby Gems权限错误

以下是针对该权限问题的具体修复方案，按优先级尝试：

修复.bundle目录权限
直接将.bundle目录的所有权改为当前用户，执行以下命令：
```
sudo chown -R $USER:staff ~/.bundle
sudo chmod -R u+rwx ~/.bundle
```
这会确保你拥有该目录的读写权限，解决临时文件写入失败的问题。
确认使用用户级Ruby版本
系统自带的Ruby会有严格的权限限制，必须使用rbenv或rvm等工具安装的用户级Ruby：
1. 检查当前Ruby路径：
```
which ruby
```
  输出应为~/.rbenv/shims/ruby或~/.rvm/rubies/[ruby版本]/bin/ruby，而非/usr/bin/ruby。
2. 如果是系统Ruby，先安装rbenv：
```
brew install rbenv
rbenv init
```
  重启终端后安装指定Ruby版本（比如3.2.2，适配CocoaPods的版本）：
```
rbenv install 3.2.2
rbenv global 3.2.2
```
  再重新安装CocoaPods：
```
gem install cocoapods
```
自定义Bundle缓存路径
若不想修改原有目录权限，可指定Bundle使用用户专属的缓存目录：
```
bundle config set cache.path ~/.local/share/bundle
```
执行完该命令后，再重新运行React Native的项目创建命令。
通过Rosetta 2运行终端
部分Ruby依赖对arm64架构支持不完善，尝试用Rosetta 2兼容模式运行终端：
1. 找到「终端」应用，右键选择「显示简介」
2. 勾选「使用Rosetta打开」，重启终端
3. 重新安装Ruby、CocoaPods，再创建React Native项目
清理旧Bundle配置
删除旧的Bundle配置文件，避免残留设置干扰：
```
rm -rf ~/.bundle/config
```
之后重新执行项目创建流程。