完全ガイド:macOSにpipをインストールする方法：

2024年10月31日

こんにちは、デジタルボーイです。備忘録がてら、macとubuntuにpipをインストールするための手順を、まとめておきます。

記事を書いた人

デジタルボーイです。
データサイエンス歴20年以上のおっさんです。中小企業診断士として、データサイエンス、WEBマーケティング、SEOに関するデータ分析、コンサルティングの仕事をしています。自己紹介の詳細はコチラ

お時間のない人のための、結論！！

pipをmacOSやLinuxにインストールするには以下のコマンドで実行できます。

方法１：

python -m ensurepip --upgrade

もしくは、以下のようにget-pipというツールからもインストール可能です。

方法２：

$ curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
$ python3 get-pip.py

環境設定

検証環境

macOS
Python 3.11.10 (Docker使用)

検証用の仮想環境

＜pip install updateをやるまでの、環境整備の事前準備です。お時間のない人はすっ飛ばしてください＞

1. インストール検証用の仮想環境を作る

すでに、僕の環境にはpipが入っているのでまっさらな環境構築のため、今回はDockerを使った仮想環境を作って、インストールを検証します。まず、以下の内容の Dockerfile を作成します。

FROM python:3.11-slim

RUN apt-get update && apt-get install -y curl

CMD ["/bin/bash"]

2. Dockerビルド

ターミナルで、Dockerfile があるディレクトリに移動し、Dockerイメージをビルドします。コンテナ名はpython311-no-pipとしておきました。

docker build -t myenv .

3. Dockerコンテナの実行

Dockerコンテナを実行し、pythonのパスを通す。

docker run -it myenv

Docker上に、pipが入っているので、アンインストール

root@xxxx:/# pip --version
pip 24.2 from /opt/homebrew/lib/python3.11/site-packages/pip (python 3.11)

root@xxxx:/# pip uninstall pip
(略)
  Successfully uninstalled pip-24.0

root@xxxx:/# pip --version
No such file or directory

無事確認できました！実は、pipなしの環境を作るのに、結構てこずりました。。。

MacOSへのターミナルによるpipのインストール手順

ここからは、　pipの公式サイトの手順に則ってインストールしてみます。MacOSとLinuxでは、同じ手順のようですね（pip公式サイト）。検証環境的にはdockerなのでLinuxですが。。。

やり方1：`ensurepip`でpipをインストール

ここまで、手こずりましたが以下のコマンド、一発でインストールできます。

python -m ensurepip --upgrade

以下は実際のアウトプットです。

ちなみに、今回の仮想環境では一度、既存のpipをアンインストールしている関係で、pipではなく、pip3としてインストールされています。

root@xxx:/# pip --version
bash: /usr/local/bin/pip: No such file or directory

root@xxx:/# pip3 --version
pip 24.0 from /usr/local/lib/python3.11/site-packages/pip (python 3.11)

（pipを操作する場合、pip3と指定すれば問題ありませんが、めんどくさいので、番外編でパスの通し方も解説しています。）

やり方2：`get-pip.py`でpipをインストール

基本的に、やり方1で問題ないはずですが、インストールできなかった場合は次の方法を試してみてください。ちなみに、公式にはどちらのやり方も書かれています。

手順としては、

pipをインストールするためにというツールをわざわざダウンロードし、その後、ファイルを指定しじっこうしていました。

get-pip.pyというツールをhttps://bootstrap.pypa.io/get-pip.pyからダウンロードします。
ターミナル/コマンドプロンプトを開き、ファイルのある場所からget-pip.pyを実行します。

get-pip.pyのダウンロード

$ curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

get-pip.pyの実行

$ python3 get-pip.py

これでインストール完了です！

番外編：pip3からpipにパスを通すには

以下の手順で、パスを通すことが可能です。

ln -s /usr/local/bin/pip3 /usr/local/bin/pip
alias pip=pip3

1番目のコマンドはln -s <現状のパス> <新たなパス>となっています。

ちなみに、<現状のパス>を確認するには以下で確認できます。

$ which pip3
/usr/local/bin/pip3

<新たなのパス>は本来のpipのパスであり、以下のコマンドのパスの部分です

$ pip --version
bash: /usr/local/bin/pip: No such file or directory

ちょうど、以下の部分がpipにリンクされているパスです。

まとめ

以上で、macOS(とLinuxも)にpipをインストールする手順でした！