macOS 업데이트 이후 xcrun error가 발생한다면 이 방법으로 해결!

xcrun: error: invalid active developer path 에러 발생했을 때 해결 방법

 
최근 macOS 버전을 Monterey에서 Ventura로 업데이트를 했고 터미널에 git 명령어를 입력했더니 아래와 같은 에러가 발생했습니다.

% git -v
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

맥북 소프트웨어 업데이트 이후 개발 도구를 사용할 때 발생되는 문제인데요, 그 원인과 해결 방법에 대해 알아보도록 하겠습니다.
 
 

에러 메시지 분석하기

해당 오류는 Xcode Command Line Tools의 유효하지 않은 활성 개발자 경로(Invalid active developer path)로 인해 발생합니다.
오류 메시지에서 보여주는 경로인 /Library/Developer/CommandLineTools에 있는 xcrun이라는 도구가 누락되었거나 올바르게 설정되지 않아서 해당 오류가 발생하게 됩니다.
 

원인

1. Xcode Command Line Tools가 설치되지 않았거나 업데이트되지 않은 경우
2. 업데이트나 시스템 변경으로 인한 경로 불일치
3. Xcode가 설치되지 않은 경우

macOS 시스템을 업데이트하면 Xcode Command Line Tools의 경로가 이전 경로에서 새 경로로 변경될 수 있거나 Xcode Command Line Tools가 제대로 업데이트되지 않을 수 있어서 소프트웨어 업데이트 후에는 Xcode Command Line Tools를 재설치하거나 업데이트해야 할 수 있습니다.
 

해결 방법

터미널에 아래 명령어를 입력해줍니다.

xcode-select --install

'xcode-select' 명령어는 명령어 라인 개발자 도구가 필요합니다. 도구를 지금 설치하겠습니까? ➡️ 설치 ➡️ 사용권 계약 ➡️ 동의

 
설치 진행 (시간이 오래 소요될 수 있습니다.) ➡️ 설치 완료

 

실행 확인

% git -v
git version 2.39.2 (Apple Git-143)

개발 도구가 정상적으로 사용되는 것을 볼 수 있습니다.
 
맥 OS 업데이트 이후에 이런 에러가 나온다면 당황하지 말고 차근차근 해결하시길 바랍니다!