macOS更新后Git无法使用的解决办法

技术背景

在进行macOS系统更新后，可能会遇到Git无法正常使用的问题，报错信息通常为 xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools)。这是因为macOS更新后，Xcode Command-line Tools需要进行更新。

实现步骤

步骤一：接受Xcode软件许可协议

重启电脑后打开终端，尝试执行 git status 命令，可能会出现错误并提示接受命令行软件协议。按空格键滚动到 [agree, print, cancel] 选项，输入 agree 并回车，将启动更新。若不小心跳过，可使用 sudo xcodebuild -license 再次调出。

步骤二：安装Xcode Command-line Tools

• 方法一：使用命令行安装
  在终端输入 xcode-select --install，会收到提示信息 xcode-select: note: install requested for command line developer tools，随后会弹出窗口提示更新Xcode Command Line tools，此过程可能需要一些时间。更新完成后，打开新的终端窗口，开发工具应该就能正常使用了。
• 方法二：从开发者网站下载安装
  若使用 xcode-select --install 命令安装失败，出现 “Software not found on server” 弹窗，可登录 Apple Developer下载页面，在下载列表中找到 “Command Line Tools for Xcode 14.x” 并点击dmg文件进行下载安装。

步骤三：重启电脑

安装完成后，必须重启电脑，否则可能会陷入提示和下载的循环。重启后，CLI工具（包括Git）的安装将完成，即可正常使用Git。

核心代码

# 接受Xcode软件许可协议（若不小心跳过）
sudo xcodebuild -license

# 使用命令行安装Xcode Command-line Tools
xcode-select --install

# 重置Xcode路径
sudo xcode-select --reset

# 设置Xcode路径
sudo xcode-select -switch /Library/Developer/CommandLineTools

最佳实践

• 在进行macOS系统更新前，备份重要数据，以防数据丢失。
• 优先选择稳定版本的Xcode Command-line Tools进行安装，避免使用alpha或beta版本，以确保软件的稳定性。
• 安装完成后，重启电脑，确保更新生效。

常见问题

安装循环问题

若在安装过程中陷入循环，可尝试执行 xcodebuild -runFirstLaunch 命令。

找不到软件问题

若使用 xcode-select --install 命令时提示 “Software not found on server”，可从 Apple Developer下载页面 手动下载安装 “Command Line Tools for Xcode 14.x”。

多版本Xcode问题

若安装了多个版本的Xcode，可通过以下命令重置或切换Xcode路径：

# 重置Xcode路径
sudo xcode-select --reset

# 切换到指定Xcode路径
sudo xcode-select -switch /Applications/Xcode.app

Homebrew问题

若使用Homebrew，在重新安装Command Line tools后，需要更新Homebrew，无需卸载并重新安装。