【解決法】Pythonで「pip install invalid syntax」エラーが出る原因と対処法

pipパッケージインストーラーは、コマンドラインから実行する必要があります。PythonインタープリタやPythonプログラムの中からパッケージをインストールしようとすると、「SyntaxError: invalid syntax」というエラーが発生します。

この記事では、pip install invalid syntaxエラーの原因と意味を解説し、実際の例を通してエラーを修正する方法をわかりやすく説明します。

pip install invalid syntaxエラーとは

Pythonのpipはパッケージインストーラーです。pipツールを使えば、Python Package Index（PyPI）からパッケージをダウンロードしてインストールできます。PyPIには数千ものライブラリが公開されており、自分のコードで自由に活用することが可能です。

pipツールは独立したコマンドラインインターフェースとして動作します。pipはPython本体とは別のものであり、これはpipがコードを実行するためのツールではなく、あくまでインストーラーであるためです。

もしpipがPythonに組み込まれていたら、パッケージをインストールしたい開発者にとって混乱を招きます。Pythonプログラムを起動する構文と、モジュールをインストールする構文が似通ってしまうからです。

この仕組みは他のプログラミング環境でも共通しています。たとえばNode.jsでは、パッケージのインストールにはnpmを使い、プログラムの実行にはnodeコマンドを使い分けます。

エラーが発生する具体例

ここでは、開発環境にBeautiful Soup 4ライブラリ（bs4）をセットアップしてみましょう。このライブラリを使うと、Webページをスクレイピングして特定のデータを取得できます。

まず、Python 3のシェルを開きます。このシェル上でプロジェクトの作業を行います。

python3

対話型シェルが開き、ここにPythonコードを入力できるようになります。

Python 3.8.5 (v3.8.5:580fbb018f, Jul 20 2020, 12:11:27)
[Clang 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>

次に、bs4ライブラリをコードにインポートします。外部ライブラリは、プログラムやシェルで参照する前に必ずインポートする必要があります。bs4パッケージをインポートするには、以下のコマンドを使用します。

>>> from bs4 import BeautifulSoup
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'bs4'

パッケージをインポートしようとすると、ModuleNotFoundErrorが返されました。これはプログラムの作成を続けられないことを意味します。Pythonが必要なパッケージのモジュールを見つけられないのです。そこで、bs4ライブラリをインストールしてこのエラーを解消しましょう。

>>> pip install bs4

しかし、このコマンドを実行すると今度は別のエラーが発生します。

File "<stdin>", line 1
    pip3 install bs4
        ^
SyntaxError: invalid syntax

どうやら、Pythonシェル内ではpip3コマンドを使ってbs4をインストールできないようです。pip3はPython 3用パッケージのインストーラーです。

解決策

先ほどの操作では、Pythonインタープリタから直接bs4パッケージをインストールしようとしていました。

python3コマンドでPython 3を起動した後、そのままpip3 installコマンドを実行したためです。

Pythonが「pip install invalid syntax」エラーを返すのは、pipがPythonのキーワードではないためです。pipはコマンドラインシェルから実行しなければならないコマンドラインツールです。

このエラーを修正するには、まずPythonシェルを終了します。

>>> exit()

exit()コマンドは、開いているPythonインタープリタを閉じるための命令です。次に、コマンドプロンプトからbs4をインストールしましょう。

pip3 install bs4

このコマンドでbs4ライブラリがシステムにインストールされます。コマンドの実行が完了したら、新しいPythonシェルを開きます。

python3

新しいシェルではbs4ライブラリにアクセスできるはずです。以下のようにbs4をインポートして確認してみましょう。

>>> from bs4 import BeautifulSoup
>>>

エラーが発生しませんでした。これはインポートが成功したことを意味します。これでプログラム内でbs4を自由に使用できるようになりました。

まとめ

「pip install invalid syntax」エラーは、Pythonインタープリタ内からパッケージをインストールしようとしたときに発生します。このエラーを解決するには、exit()でインタープリタを終了し、コマンドラインシェルからpip installコマンドを実行してください。

これで、プロのコーダーのようにこのエラーを解決できる知識が身につきました！