终端搭建Mac CI遇阻：AWS无GUI macOS ARM机器无法下载Xcode求助

1. 先安装Command Line Tools（CLT） #

这是基础依赖，执行以下命令：

xcode-select --install

如果提示已安装，直接跳过。

2. 用mas工具从Mac App Store安装Xcode #

mas是终端版Mac App Store工具，适配无GUI场景：

• 未安装Homebrew的话先部署：

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

• 安装mas：

  brew install mas
  

• 登录Apple ID（终端内会弹出登录界面，输入密码和双重认证码）：

  mas signin --dialog your-apple-id@example.com
  

• 搜索Xcode的ID（通常为497799835）：

  mas search Xcode
  

• 启动Xcode安装：

  mas install 497799835
  

  注意：安装过程耗时较长，取决于网络速度。

3. 完成Xcode初始化 #

安装后必须执行以下两步才能正常使用xcodebuild：

• 同意许可协议：

  sudo xcodebuild -license accept
  

• 完成首次启动初始化：

  sudo xcodebuild -runFirstLaunch
  

4. 验证功能正常 #

• 查看Xcode版本：

  xcodebuild -version
  

• 测试项目编译（替换为你的项目信息）：

  xcodebuild -project YourProject.xcodeproj -scheme YourScheme build
  

替代方案：手动下载Xcode压缩包 #

如果mas或xcinfo下载失败，可尝试手动方式：

1. 用开发者账号登录Apple Developer网站，找到对应ARM架构的Xcode版本，复制下载链接
2. 终端用curl下载（替换为实际链接）：

   curl -O https://developer.apple.com/services-account/download?path=/Developer_Tools/Xcode_15.0/Xcode_15.0.xip
   

3. 解压压缩包：

   xip -x Xcode_15.0.xip
   

4. 移动到应用目录：

   sudo mv Xcode.app /Applications/
   

5. 再执行步骤3的初始化命令即可。

常见问题排查 #

• 权限报错：添加sudo重新执行命令
• 下载失败：切换稳定网络，或使用手动下载方式
• 初始化失败：检查磁盘空间，Xcode至少需要20GB以上可用空间

内容的提问来源于stack exchange，提问作者Taha Selim Bebek