macOS xcrun invalid active developer path 오류 해결 순서

macOS 업데이트 후 Git이나 컴파일러 실행 시 xcrun 개발자 경로 오류가 발생할 때 Command Line Tools 상태를 복구하는 방법입니다.

Xcode Command Line ToolsmacOS

짧은 요약

macOS 업데이트 뒤 선택된 개발자 디렉터리가 사라지거나 Command Line Tools가 불완전하면 xcrun: error: invalid active developer path가 발생합니다. 현재 경로를 확인하고 공식 설치 명령으로 도구를 복구하세요.

git, clang, make를 실행할 때 다음과 유사한 오류가 표시됩니다.

xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools)

시스템 업데이트 과정에서 Command Line Tools가 제거·비활성화됐거나 xcode-select가 존재하지 않는 Xcode 경로를 가리킵니다.

xcode-select -p
xcrun --find clang
git --version

첫 명령이 없는 경로를 반환하거나 두 번째 명령이 실패합니다.

xcode-select --install

이미 설치됐다는 메시지가 나오면 다음 단계에서 현재 선택 경로를 확인합니다.

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

Command Line Tools만 사용하는 경우 일반적인 경로는 다음과 같습니다.

sudo xcode-select --switch /Library/Developer/CommandLineTools

해당 디렉터리가 실제로 존재할 때만 선택하세요.

전체 Xcode를 새로 설치했다면 필요할 때 다음 명령으로 라이선스 안내를 완료합니다.

sudo xcodebuild -license

xcode-select -p
xcrun --find clang
clang --version
git --version

모든 명령이 오류 없이 실제 경로와 버전을 보여야 합니다.

인터넷에서 받은 임의의 개발 도구 디렉터리를 복사하지 마세요. macOS 버전과 호환되는 Apple 공식 Command Line Tools 또는 Xcode를 사용해야 합니다.