Xcode 安装卡住解决方案

问题描述

许多 macOS 用户在通过 App Store 安装或更新 Xcode 时遇到安装进度停滞的问题。常见情况包括：

• 进度条卡在 75-80% 或特定百分比
• 显示 "正在安装" 但长时间无进展
• Launchpad 中显示灰色图标或带进度环的图标
• 安装过程看似完成（如显示 7.2GB/7.2GB）但实际上未完成

解决方案总览

根据用户反馈和解决方案汇总，以下是针对 Xcode 安装卡顿的有效解决方法，按推荐顺序排列。

1. 使用控制台监控真实进度

最可靠的方法是使用 macOS 的控制台应用查看实际安装进度：

查看详细安装进度

1. 保持 App Store 窗口打开
2. 打开"控制台"应用（在"应用程序" > "实用工具"中）
3. 在搜索栏中输入 "App Store"
4. 点击"开始"按钮
5. 观察日志中的进度信息，如："Completed: 825 of 1000"

即使界面显示卡住，控制台可能显示安装仍在缓慢进行。

TIP

安装过程可能极其缓慢，特别是在基础型号 Mac（如 M1 MacBook Air 8GB）上，可能需要长达 24 小时。

2. 检查并接受许可协议

有时安装卡住是因为需要接受新的许可协议：

1. 打开 App Store
2. 点击左下角的账户按钮
3. 查看是否有需要接受的内容
4. 点击接受并输入 Apple ID 密码

3. 重启相关进程

通过终端命令重启 App Store 相关服务：

# 终止所有 App Store 相关进程
sudo killall appstoreagent
sudo killall com.apple.AppStoreDaemon.StoreAService
sudo killall com.apple.AppStoreDaemon.StorePrivilegedTaskService
sudo killall installd
sudo killall installcoordinationd
sudo killall system_installd
sudo killall uninstalld

执行后重新打开 App Store，安装通常会继续。

4. 防止系统睡眠

Mac 进入睡眠模式会中断安装过程：

# 在终端中运行，防止系统睡眠
caffeinate

安装完成后，按 Control+C 退出 caffeinate 命令。

5. 替代安装方法

如果 App Store 持续出现问题，可以考虑其他安装方式：

通过开发者门户下载

1. 访问 Apple Developer 下载页面
2. 下载所需版本的 Xcode (.xip 文件)
3. 使用终端解压：

xip -x ~/Downloads/Xcode_版本号.xip

仅安装命令行工具

如果只需要命令行工具：

xcode-select --install

6. 检查磁盘空间

即使看似有足够空间，系统可能仍认为空间不足：

创建并删除临时文件释放空间

# 创建一个大临时文件（示例为4GB）
cd ~/Documents
mkfile 4G temp_file.mov

# 立即删除该文件
rm temp_file.mov

此方法可以清理系统缓存的空间计算问题。

7. 关闭可能干扰的服务

• 禁用 VPN 或特殊 DNS 服务（如 1.1.1.1）
• 暂时关闭防病毒软件的文件防护功能
• 确保网络连接稳定

常见情况处理

注意事项

• 安装 Xcode 确实需要很长时间，特别是在较旧的或基础型号的 Mac 上
• M1/M2 芯片 Mac 用户报告安装时间可能超过 12 小时
• 保持耐心并确保电源连接

如果所有方法都失败

作为最后的手段：

1. 强制退出 installd 进程（通过活动监视器）
2. 删除现有的 Xcode 应用
3. 重启 Mac
4. 重新从 App Store 下载安装

结论

Xcode 安装卡住通常是正常但极其缓慢的安装过程，而非真正卡死。建议首先使用控制台应用验证安装是否仍在进行，然后按照上述步骤排查问题。对于急需使用的情况，从开发者门户直接下载通常是更可靠的选择。

版本说明

本文基于 Xcode 12.5 至 14.3.1 版本的安装问题总结，解决方案适用于 macOS Big Sur 至 Ventura 系统。