ライブラリのインストールと仮想環境

D2MatE pythonページ (より進んだ話題)


ライブラリのインストール

pythonでは様々なライブラリ・パッケージを利用することで多くの機能を簡単に使うことができます。 ライブラリ・パッケージのインストールのため、 pip が標準パッケージマネージャとして用意されています。

注釈

anaconda, minicondaには conda という独自パッケージマネージャが用意されています。conda コマンドの使い方は、ChatGPTなどに質問してください。


仮想環境の作成

pythonプログラムでは多くのライブラリ・パッケージを使いますが、相互に依存しているライブラリ・パッケージが特定のバージョンでないと動かない場合があります。 そのため、使用するプログラム、ライブラリ・パッケージごとに仮想環境を作って切り替えることが推奨されています。

  • 1. 仮想環境を作るディレクトリに移動する 例:

    > chdir \
    > mkdir myenv
    > chdir myenv
    
  • 2. 仮想環境の作成 例:

    > python -m venv tkprog
    
  • 3. 仮想環境の実行 例:

    • Windows: > .\tkprog\Scripts\activate

    • Linux: % source ./tkprog/bin/activate

  • 4. 仮想環境から抜ける 例:

    > deactivate
    

pip 簡易マニュアル

  • パッケージのインストール > pip install パッケージ名

  • 最新版にする > pip install --upgrade パッケージ名

  • バージョン指定でインストール > pip install パッケージ名==バージョン番号 > pip install "numpy<2"

  • アンインストール > pip uninstall パッケージ名

  • インストール済みパッケージの一覧 > pip list

  • 特定のパッケージのバージョン表示 > pip show パッケージ名 > python -c "import numpy; print(numpy.__version__)"

  • パッケージを指定して、使えるバージョンを調べる 以下のオプションは廃止されたため、 pip-search などで確認してください。 (~~`pip search パッケージ名==`~~)

  • バージョン競合などが発生した場合に、強制的にインストール > pip install --force-reinstall パッケージ名==バージョン番号

  • ユーザーのホームディレクトリにパッケージをインストール > pip install --user パッケージ名


ライブラリがインストールできない場合の対処法

  1. pythonとpipのバージョン・パスを確認する 複数のpython環境が混在している場合、実行しているpythonとpipのバージョンがずれていることがあります。

    > python --version
    > pip --version
    > where python (Linux: % which python)
    > where pip (Linux: % which pip)
    

    対応が怪しい場合、pythonコマンドを介してインストールを試してください。

    > python -m pip install モジュール名
    
  2. pipとwheelを最新版にする

    > pip install --upgrade pip
    > pip install wheel
    
  3. パッケージをインストール、あるいは最新版にする

    > pip install パッケージ名
    > pip install --upgrade パッケージ名
    
  4. 再試行 それでも No module エラーが出るようであれば、アンインストールしてやり直します。

    > pip uninstall パッケージ名
    > pip install パッケージ名
    

それでも解決しない場合

仮想環境を新しく作って全ライブラリを再インストールする方が簡単ですが、以下の確認も有効です。

  • インストール済みライブラリの確認: > pip list

  • 特定のパッケージの詳細表示: > pip show パッケージ名

  • バージョン指定(ダウングレード)での解決: > pip install パッケージ名==バージョン番号 > pip install --force-reinstall パッケージ名==バージョン番号


pythonライブラリのインストール例

  1. 最初に、pip を最新版にする

    > python -m pip install --upgrade pip
    
  2. tkProgのインストールに必要なライブラリをインストール

    > pip install requests beautifulsoup4
    

Obsolete

Old manual: http://d2mate.mdxes.iir.isct.ac.jp/D2MatE/python/python_install_packages.html