【解決済み】Virtualenvで「コマンドが見つかりません」エラーが出る原因と直し方

Virtualenvは、Pythonプロジェクトごとに独立した仮想環境を作成するための定番ツールです。必要な実行ファイルをまとめたフォルダを生成し、プロジェクト間でパッケージや依存関係が混ざらないようにしてくれます。しかし最近、macOS環境でVirtualenvのコマンドを実行しようとした際に「コマンドが見つかりません（Command Not Found）」というエラーが表示されるという報告が多数寄せられています。

この記事では、このエラーの主な原因と、確実に解決するための手順を順番に解説していきます。

Virtualenvで「コマンドが見つかりません」エラーが発生する原因

多くのユーザーからの報告をもとに調査を行った結果、このエラーは主に以下の2つの要因によって引き起こされることが判明しました。

• インストール先のディレクトリが誤っている：特定の「pip」コマンドでプログラムをインストールすると、「/usr/local/bin」以外のディレクトリに配置されてしまうことがあります。正しく動作するためには「/usr/local/bin」ディレクトリへのインストールが必要なため、これがエラーのトリガーとなります。
• 管理者権限（スーパーユーザー権限）が不足している：プログラムを適切なディレクトリに配置し、コマンドとして認識させるには、管理者権限（Superuser権限）でのインストールが必要です。一般ユーザー権限のままインストールすると、このエラーが発生する可能性があります。

問題の概要を理解したところで、具体的な解決策に進みましょう。競合を避けるため、以下の順番どおりに試すことをおすすめします。

解決策1：インストール先ディレクトリを変更する

プログラムが正しいディレクトリにインストールされていない場合、このエラーが発生することがあります。そこで、まずはインストール先を適切な場所に変更します。

1. 画面右上の「Spotlight（虫眼鏡アイコン）」をクリックします。
2. 「Terminal（ターミナル）」と入力し、候補の一番上を選択して起動します。
3. 通常、このツールは次のコマンドでインストールされているはずです。

   pip install virtualenv

4. 続けて、以下のコマンドを入力して「Enter」キーを押します。

   sudo /usr/bin/easy_install virtualenv

5. これでプログラムが適切なディレクトリに配置されます。エラーが解消されたかどうかを確認してください。

解決策2：管理者権限で再インストールする

一般ユーザーとしてインストールされ、ルート権限が付与されていないことが原因の場合もあります。そこで、管理者権限を使って再インストールを行います。

1. 画面右上の「Spotlight（虫眼鏡アイコン）」をクリックします。
2. 「Terminal（ターミナル）」と入力し、候補の一番上を選択して起動します。
3. まず、以下のコマンドを入力して「Enter」キーを押し、既存のVirtualenvをアンインストールします。

   pip uninstall virtualenv

4. 次に、以下のコマンドを入力して「Enter」キーを押します。

   sudo pip install virtualenv

5. これにより管理者権限でインストールされます。エラーが解消されたかどうかを確認してください。

解決策3：APT-GETコマンドでインストールする

pipコマンドでのインストールでは改善しないケースもあります。その場合は、「APT-GET」コマンドを使用してvirtualenvをインストールしてみましょう。

1. 画面右上の「Spotlight（虫眼鏡アイコン）」をクリックします。
2. 「Terminal（ターミナル）」と入力し、候補の一番上を選択して起動します。
3. 以下のコマンドを入力して「Enter」キーを押します。

   sudo apt-get install python-virtualenv

4. エラーが解消されたかどうかを確認してください。