pip install --upgrade pipでpipのバージョンを上げるとImportError: cannot import name mainで動かなくなった話

aptでpipをインストールした後にpipのバージョンアップを試みると、pipが動かなくなってしまったのでその対策をまとめます。

現象#

WSL (Windows Subsysmte for Linux)、つまりUbuntu 16.04でpipのバージョン9以上を使いたかったのです。でもaptでインストールされたのはpip 8.1.1だったのでpipをアップグレードをしたら、pipが壊れて動かなくなりました。

やったこと#

1
# pipのインストール
2
$ sudo apt install python-pip
3

4
# バージョン確認
5
$ pip --version
6
pip 8.1.1 from /usr/lib/python2.7/dist-packages (python 2.7)
7

8
# pip 9以上を使いたかったのでのバージョンアップ
9
$ pip install --upgrade pip

起きたエラー#

pipコマンドが壊れて、pipで何かやろうとするとこのエラーが出るようになってしまいました。

1
$ pip
2
Traceback (most recent call last):
3
  File "/usr/bin/pip", line 9, in <module>
4
    from pip import main
5
ImportError: cannot import name main

なぜこのエラーが起きるかの原因については、こちらのサイトがわかりやすかったです。どうにもpip 10からディレクトリ構造など諸々変わってしまったのが原因みたい・・・。

pip install —upgrade pip (10.0.0) 後の奇妙な挙動について - 雑記

対策#

pipのアンインストール#

とりあえずpipを一旦アンインストールします。

1
# pipのアンインストール
2
$ sudo apt --purge remove python-pip

このままもう1回aptでpipをインストールしても動かなくなってしまっているので、pipを完全にアンインストールしてやります。

1
$ python -m pip uninstall pip

これでpipインストール前の綺麗な状態に戻りました。

aptを使わずにpipをインストール#

aptのpipパッケージが新しくなればこのアップデートで動かなくなる問題も解決するかもしれませんが、今回はaptを使ったpipのインストールは諦めて、使わない方法に切り替えます。

1
# aptを使わずpipのインストール
2
$ curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
3
$ sudo python get-pip.py

これでpipがインストールされました。バージョンを確認すると、目的のpip 9以上がインストールされているのが確認できます。

1
$ pip --version
2
pip 18.1 from /usr/local/lib/python2.7/dist-packages/pip (python 2.7)