macOS Catalina以降で「zsh: command not found」エラーが出たときの原因と対処法まとめ

2019年にmacOS Catalinaがリリースされて以降、MacのデフォルトログインシェルはBashからZshへと切り替わりました。その影響で、システムアップデート後に一部のコマンドが使えなくなるケースがあります。Macのターミナルでコマンドを実行しようとした際に、「zsh: command not found（コマンドが見つかりません）」というエラーに遭遇したことはありませんか？このエラーはMacでコマンドラインを使う際によくある問題で、「入力されたコマンドが無効と判断された」ことを意味しています。

エラーの原因としては、コマンドがシステムにインストールされていない、構文の誤り、スペルミスなどが考えられます。幸いなことに、トラブルシューティングと解決のために試せる対策はいくつか存在します。本記事では、原因から具体的な解決手順まで詳しく解説します。

Part 1：「zsh: command not found」エラーとは？

UnixやLinux、macOSを使用している多くのユーザーが「zsh command not found python mac」といったエラーに悩まされ、フォーラムで回答を探し続けています。そこで本記事では、この問題に対するあらゆる解決策をご紹介します。まず、最も一般的な原因は以下の通りです。

• コマンドのスペルミスや入力ミス
  MacでZshコマンドを使い始めたばかりの頃は、余計な記号を入れてしまったり、必要なスペースを入れ忘れたりといったミスが起こりがちです。誤って入力されたコマンドはmacOSが正しく認識できず、エラーとして表示されます。「command not found」エラーが出たら、まずコマンドの入力内容を確認しましょう。

• コマンドは正しいが、必要なパッケージがインストールされていない
  コマンド自体は正しいのに、実行に必要なパッケージが未インストールのためエラーが出るケースです。スペルミスがないのにエラーが出る場合は、必要なパッケージがインストールされているかを確認してください。

• Zshのデフォルト環境設定の変更による影響
  macOSが新バージョンにアップグレードすると、従来のコマンド環境が変化します。多くのLinux系Bashコマンドは保存されていますが、Zshコマンドとの互換性がない場合があります。Zshはデフォルトでは以前のアドレスから環境変数を読み込まないためです。

Part 2：Macで「zsh: command not found」エラーを修正する基本の3つの方法

Macの「command not found」エラーにはいくつかの原因があります。このエラーはMontereyをはじめ、ZshをサポートするすべてのmacOSバージョンで発生する可能性があり、どのコマンドでも起こり得ます。以下の方法を一つずつ試して、コマンドが正常に実行されるまで確認することをおすすめします。

方法1：macOS再インストール時に削除したデータを復元する

macOSの再インストールは、Zsh関連のエラー解決に役立つことがあります。しかし、再インストールやアップデート後のデータ保護も非常に重要です。誤った操作によってファイルやデータが失われる可能性があるため、データセキュリティへの配慮が必要です。そんなときに頼れるのが、4DDiG Mac Data Recoveryのような優れたデータ復元ツールです。

• MacおよびUSBメモリ、SDカード、デジタルカメラなどMac接続デバイスから失われたデータをすべて復元可能
• 高い成功率を誇る安全なMacデータ復元
• T2チップ、M1、M1 Pro、M2、M3、M4、macOS Sequoiaに対応
• 3クリックでデータ復元完了。SIPの無効化は不要

• 4DDiG-Macをインストールしたら、データ復元を開始する場所（ローカルドライブなど）を選択します。場所にカーソルを合わせると右下に「スキャン」アイコンが表示されるので、クリックして失われたファイルの検索を開始します。

• スキャン結果が表示されたら、ファイルタイプをクリックして詳細プレビューを確認できます。

• 「復元」をクリックし、保存先を選択します。データを完全に失わないよう、復元したファイルは紛失元とは別のパーティションに保存してください。

方法2：コマンドの構文を確認する

ターミナルで「zsh: command not found」エラーが表示されたら、まずコマンドの構文を見直しましょう。手打ちではなく、元のテキストをコピー＆ペーストするのが確実です。また、同じコマンドを使った他の例と見比べるのも有効です。

コマンドに不慣れなユーザーは、必要なスペースの入れ忘れや余計な記号の挿入といったミスをしがちです。例えば、Nanoでホストファイルを編集する際、正しい構文は「sudo nano /private/etc/hosts」（nanoの後に半角スペース）ですが、「sudo nano/private/etc/hosts」と入力してしまうことがあります。

また、ドキュメントから「$ brew install pyqt」のような行をそのままコピー＆ペーストすると、「-bash: $: command not found」というエラーが返されます。これは「$」がドキュメント上のサンプルプロンプトであり、実際のコマンドには含める必要がないためです。

方法3：macOSを再インストールする

macOSのシステムをいじっているうちに、うっかりシステムファイルやフォルダを削除してしまった場合はどうすればよいのでしょうか。ターミナルの動作に必要なファイルを誤って消去した可能性もあります。そのような場合は、削除されたファイルの復元を試みてください。

ドライブをフォーマットせずにmacOSを再インストールすれば、初期設定を復元し、「zsh: command not found」エラーを解消できることがあります。OSの再インストールでデータが失われることは通常ありませんが、重要な書類は事前にバックアップしておくのが安心です。万が一重要なデータが見つからない場合は、再インストール後にファイル復元を試みましょう。

Part 3：その他の3つの解決方法

方法4：「$PATH」環境変数を確認する

パスとは、ファイルシステム内の特定の場所を示すものです。同様に、ターミナルコマンドにおいてPATH環境変数（$PATH）は、実行可能プログラムが格納されている各ディレクトリを示します。$PATHが正しく設定されていれば、Macはコマンド実行時にどこを探せばよいか分かるため、絶対パスを入力する必要はなく、「ls」のようにコマンド名だけで実行できます。

実行したいコマンドへのパスが設定されていないと、「zsh command not found python mac」や「zsh: command not found ls」といったエラーが発生します。その場合は、コマンドが保存されている$PATHが正しく設定されているかを確認しましょう。

ターミナルを起動し、macOSがコマンドラインで使用する標準パスを設定するために、以下のコマンドを実行します。

• export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" を入力
• パスワードを入力してEnterキーを押す
• 以前失敗したコマンドを再度実行し、macOS Montereyでエラーが再発しないか確認する。問題が残る場合は次の対処法へ進みます。

方法5：.zshrcファイルでZshコマンドのパスを設定する

プログラムをインストールしてパス変数を設定しても、ターミナルを一度終了して再ログインすると、また「zsh: command not found」エラーが出ることがあります。これを恒久的に解決するには、.zshrcファイルでコマンドパスを編集します。

.zshrcファイルは、ターミナルを閉じて再度開くたびに自動的に実行され、コマンドパスを設定してくれます。編集手順は以下の通りです。

• Macのターミナルを起動する
• 「zsh」と入力してEnterキーを押し、Zshシェルを使用する
• ウィンドウに「nano ~/.zshrc」と入力する
• $PATH変数の情報を追加する
• Control + X、Y、Enterの順に押してNanoエディターを終了し、ファイルを保存する
• 「source ~/.zshrc」コマンドを実行して変更を反映させる

方法6：必要なパッケージがインストールされているか確認する

コマンドを実行しようとしても、必要なパッケージがインストールされていないためにエラーになるケースは頻繁にあります。コマンドが正しく、スペルミスもないのにエラーが出る場合は、そのコマンドに対応するパッケージをMacにインストールし忘れていないかを必ず確認してください。

Part 4：よくある質問（FAQ）

Q1：なぜMacで「zsh: command not found」エラーが表示されるのですか？

デフォルトシェルであるZshが要求されたコマンドを認識できないときに、この警告が表示されます。コマンドが存在しないか、システムのPATHに登録されていないことを意味します。スペルを確認し、コマンドがインストール済みであること、またはPATH環境変数に追加されていることをチェックしましょう。

Q2：MacにZshターミナルをインストールするには？

• Zshをインストールする前に、Homebrewがすでにインストールされているか確認します。
• まずLaunchpadで「ターミナル」と入力して起動し、コマンドラインに「brew」と入力します。Homebrewが存在しない場合は、メッセージが表示されます。
• Homebrewをインストールするには、パスワードを入力して次のコマンドを実行します：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 続いて「brew install zsh」と入力してZshをインストールします。

Q3：MacでZshコマンドに切り替えるには？

• ターミナルを開きます。
• 「zsh」と入力してEnterキーを押します。
• プロンプトがZshに切り替わり、Zshコマンドが使用できるようになります。
• Zshをデフォルトにするには「chsh -s $(which zsh)」を実行し、変更を反映させるためにターミナルを再起動します。

まとめ

「zsh: command not found」エラーの主な原因は、BashシェルとZshシェルの違いにあります。macOSのバージョンによっては完全な互換性が保証されていないこともあります。MacをアップグレードしたばかりでZshコマンドが正常に動作しない場合は、本記事でご紹介した対処法がお役に立てば幸いです。また、万一データを失った場合に備えて、4DDiG Mac Data Recoveryを活用すれば、Macのデータを効率的かつ安全に保護・復元できます。

William Bollson（シニアエディター）

William Bollsonは4DDiGの編集長として、データ復元、修復、エラー修正などWindowsとMacに関する問題のベストソリューションを提供することに尽力しています。