dotnet: command not found in Macの解決方法【2025年最新版】

エラーの概要・症状

macOSで .NETを使用しようとすると、ターミナルでdotnet: command not foundというエラーメッセージが表示されることがあります。このエラーは、.NET SDKが正しくインストールされていないか、システムのPATH環境変数に.NETのインストールディレクトリが含まれていない場合に発生します。

具体的には、以下のような症状が表れます：

• ターミナルでdotnet --versionと入力しても、コマンドが見つからないというエラーメッセージが表示される。
• .NETを利用したプログラムのビルドや実行ができない。

このエラーによって、開発環境が整わず、アプリケーションの開発やデプロイができないため、開発者にとって非常に困る事態となります。

このエラーが発生する原因

このエラーが発生する主な原因は次の通りです：

1. .NET SDKの未インストール：dotnetコマンドは、.NET SDKがインストールされていないと利用できません。まずはSDKがインストールされているか確認しましょう。

2. PATH環境変数の設定ミス：.NET SDKがインストールされていても、PATH環境変数に正しいディレクトリが含まれていない場合、コマンドが認識されません。

3. シェルの設定ミス：使用しているシェル（例えば、zshやbash）の設定ファイル（.zshrcや.bash_profile）に誤った設定があると、必要な環境変数が適切に読み込まれないことがあります。

4. インストールの不完全さ：.NET SDKのインストール中に何らかのエラーが発生し、正しくインストールされていない場合も考えられます。

解決方法1（最も効果的）

手順1-1（.NET SDKをインストール）

1. 公式サイトにアクセスし、最新の.NET SDKをダウンロードします。こちらのリンクから入手できます：Microsoft .NET.

2. ダウンロードしたインストーラーを実行し、指示に従ってインストールを完了させます。

手順1-2（PATH環境変数の確認）

1. ターミナルを開き、以下のコマンドを実行して現在のPATHを表示します：

   echo $PATH

1. .NET SDKがインストールされているパス（通常は/usr/local/share/dotnet）が含まれているか確認します。

2. 含まれていない場合、以下のコマンドを使用してPATHを更新します：

   echo 'export PATH=$PATH:/usr/local/share/dotnet' >> ~/.zshrc
   source ~/.zshrc

手順1-3（ターミナルの再起動）

1. 設定を反映させるため、ターミナルを再起動します。

2. 再度、dotnet --versionと入力し、正しく動作するか確認します。

注意点とトラブルシューティング

• .NET SDKのインストール後にPATHの設定が必要です。もし設定後もエラーが続く場合、再度echo $PATHで確認し、他のシェル設定ファイル（例：.bash_profile）にも同様の行がないか確認してください。

解決方法2（代替手段）

もし上記の方法で問題が解決しない場合、以下の手順を試してください：