シナリオ：macOSアップデート後にターミナルが動かなくなる
macOSの最新アップデートが完了したばかりだとします。作業に戻るためにターミナルを開き、git statusやmakeを入力した瞬間、ワークフローがストップしてしまいます。通常の出力の代わりに、パスが見つからないという不可解なエラーメッセージが表示されます。
エラーメッセージ
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
macOS Sequoia (15.x) や Sonoma (14.x) へのメジャーアップデートでは、Command Line Tools (CLT) への接続が切れることがよくあります。これらのツールは開発環境のバックボーンであり、Xcodeのフルセットを必要とせずに gcc、git、python3 などの必須ユーティリティを提供します。
なぜターミナルが動作しないのか
macOSのカーネルをアップデートすると、既存の開発者ツールへのパスが無効になることがよくあります。xcrun ユーティリティはコンパイラの交通整理役として機能します。/Library/Developer/CommandLineTools でツールを探し、ディレクトリが空だったりバージョンの不一致があったりすると、このエラーが発生します。要するに、OSのアップデートによってシステムはクリーンアップされましたが、開発用バイナリの再リンクが忘れられている状態です。
解決策1：高速再インストール（推奨）
ほとんどの開発者は、5分以内にこの問題を解決できます。App Storeから12GB以上もある巨大なXcodeアプリをダウンロードする必要はありません。代わりに、ターミナルから直接軽量なインストーラー（約700MB）を起動できます。
次のコマンドを実行してください：
xcode-select --install
画面にソフトウェア・アップデートのダイアログが表示されます。**「インストール」**をクリックし、使用許諾契約に同意してください。インターネットの速度にもよりますが、ダウンロードは通常2〜5分で完了します。完了すると、ツールはすぐに使用可能になります。再起動は不要です。
解決策2：フル版Xcodeアプリを指定する
すでにフルバージョンのXcodeをインストールしている場合、システムが単に間違った場所を参照している可能性があります。macOSに対して、Xcodeアプリケーション内に同梱されているツールを使用するように強制できます。
まず、パスをデフォルトの場所にリセットしてみてください：
sudo xcode-select --reset
それでも解決しない場合は、手動でXcodeアプリのディレクトリを指定します：
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
注意：これらの sudo コマンドを承認するには、Macのログインパスワードを入力する必要があります。
解決策3：「最終手段」（インストーラーが失敗する場合）
xcode-select --install コマンドを実行しても、明らかに壊れているのにソフトウェアが「インストール済みです」と表示されることがあります。その場合は、破損したフォルダを手動で削除して、最初からやり直す必要があります。
1. 古いディレクトリを削除する：
sudo rm -rf /Library/Developer/CommandLineTools
2. インストールコマンドを再度実行する：
xcode-select --install
これにより、システムにツールが不足していることを強制的に認識させ、クリーンなダウンロードを促します。
検証：本当に修正されたか？
動作したと思い込まず、環境が安定していることを確認するために、次の3つのクイックチェックを実行してください。
1. アクティブなパスを確認する：
xcode-select -p
出力として /Library/Developer/CommandLineTools が表示されるはずです。
2. Gitをテストする：
git --version
バージョン番号（例：git version 2.39.5）が返ってくれば、復旧完了です。
3. xcrunを検証する：
xcrun --find git
これはバイナリの場所（通常は /usr/bin/git）を指している必要があります。
まとめ
「invalid active developer path」エラーは、macOSのアップデート後に発生する標準的な障害です。xcode-select --install を実行することで、新しいOSとコーディングツールの間のギャップを埋めることができます。このコマンドをブックマークしておきましょう。次のmacOSバージョンがリリースされたときにも、おそらく必要になります。