PyCharm 2026.1 Help

パッケージのインストール、アンインストール、アップグレードを行う

PyCharm は、特定の Python インタープリターに対して Python パッケージのインストール、アンインストール、アップグレードを行うメソッドを提供します。 これは、各プロジェクトに独自のパッケージセットがあることを意味し、これは Python 依存関係管理のベストプラクティスと見なされます。 デフォルトでは、PyCharm はプロジェクトパッケージの管理に pip を使用します。 conda 環境では、 conda パッケージマネージャーを使用できます。

PyCharm では、 Python パッケージ ツールウィンドウおよび Python インタープリター設定でパッケージをプレビューおよび管理できます。

Python パッケージツールウィンドウでパッケージを管理する

Python パッケージ ツールウィンドウは、現在選択されている Python インタープリターのパッケージをプレビューしてインストールするための最も迅速かつ適切な方法を提供します。 このツールウィンドウはデフォルトで有効になっており、左側の Python パッケージ をクリックして開くことができます。 メインメニュー 表示 | ツールウィンドウ | Python パッケージ を使用していつでも開くことができます。

Python パッケージ ツールウィンドウには、インストールされているパッケージと、PyPI および conda パッケージリポジトリで利用可能なパッケージが表示されます。 検索フィールドを使用して、利用可能なパッケージのリストをフィルタリングします。

Python パッケージツールウィンドウ

ドキュメント領域でパッケージのドキュメントをプレビューしたり、 ドキュメント リンクをクリックしてブラウザーで開くことができます。

パッケージのインストール

  1. Python パッケージ ツールウィンドウの検索フィールドにパッケージ名の入力を開始します。 一致するパッケージが表示されます。

    Python パッケージツールウィンドウでパッケージを検索する

    現在の Python インタープリターが conda 仮想環境である場合、conda パッケージリポジトリで使用可能なパッケージも表示されます。

  2. パッケージを選択し、次のいずれかを実行します。

    • パッケージ名の横にある インストールする をクリックし、バージョンを選択します。

      検索結果からパッケージをインストールする
    • 利用可能なバージョン一覧からバージョンを選んで、 インストールする をクリックします。

      インストールするパッケージのバージョンの選択

    インストール中に pip install コマンドラインオプション(英語)を使用できます:

    • パッケージ名の横を右クリックし、 オプション付きでインストール​ を選択します。

    • 開いたダイアログで必要なオプションを入力し、 OK をクリックします。

    conda または pip でインストールされたパッケージには、対応するアイコンが付けられます。

    conda または pip でインストールされるパッケージ
  3. エラーメッセージを含むポップアップが表示された場合は、 トラブルシューティングガイドの解決策を参照してください。

パッケージリポジトリを管理する

  1. カスタムリポジトリ (devpi(英語) やプライベート PyPi サーバーなど) を指定するには、検索フィールドの横にある 設定 をクリックします。

  2. Python パッケージリポジトリ ダイアログで、 追加 をクリックします。 認証が不要な場合、例えばローカルリポジトリの場合は、リポジトリの URL を入力して OK をクリックします。

    Python リポジトリの追加: 承認なし
  3. HTTP 認証が必要なリポジトリから Python パッケージをインストールする場合は、 基本 HTTP をクリックし、リポジトリの URL とログイン資格情報を入力します。 タスクを完了するには、 OK をクリックしてください。

    Python リポジトリの追加: 基本 HTTP 認証

バージョン管理システムからパッケージをインストールする

  1. Python パッケージ ツールバーの パッケージ追加​ リンクをクリックして、 バージョン管理から を選択します。

  2. ターゲットの git リポジトリへのパスを指定します。 サポートされているパス形式の詳細については、 pip のドキュメント(英語)を参照してください。

    バージョン管理からインストール
  3. 編集可能モード (たとえば、setuptools 開発モード) でパッケージをインストールする場合は、 Install as editable (-e) を選択します。

ディスクからパッケージをインストールする

  1. Python パッケージ ツールバーの パッケージ追加​ リンクをクリックして、 ディスクから を選択します。

    ディスクからパッケージをインストールする
  2. パッケージディレクトリまたはアーカイブ( zip または whl )へのパスを指定します。

  3. 編集可能モード (たとえば、setuptools 開発モード) でパッケージをインストールする場合は、 Install as editable (-e) を選択します。

アップグレードパッケージ

  • パッケージの新しいバージョンが利用可能な場合は、現在のバージョンと最新バージョンへのリンクがパッケージ名の横に表示されます。 リンクをクリックしてパッケージを最新バージョンにアップグレードします。

    新しいバージョンのパッケージが利用可能です

    エラーメッセージを含むポップアップが表示された場合は、 トラブルシューティングガイドの解決策を参照してください。

パッケージをアンインストールする

  • インストール済みパッケージを削除するには、パッケージバージョンの横にある アンインストール をクリックします。

    Python パッケージツールウィンドウでのパッケージのアンインストール

Python インタープリター設定でパッケージを管理する

プロジェクト Python インタープリターの Python パッケージを管理するには、 設定 | Python | インタープリター に移動するか、 Python インタープリターセレクターインタープリターの設定 を選択します。 次に、 Python インタープリター フィールドでインタープリターを選択します。

インストールされている Python パッケージの表示

パッケージのインストール

  1. ツールバーの インストールする をクリックします。

    Add a package
  2. 開いた 使用可能なパッケージ ダイアログで、検索フィールドにパッケージの名前を入力します。

    利用可能なパッケージを表示する
  3. 必要に応じて、次のチェックボックスをオンにします。

    • バージョンを指定する: このチェックボックスをオンにすると、リストから目的のバージョンを選択できます。 デフォルトでは、最新バージョンがインストールされます。

    • オプション: このチェックボックスを選択すると、テキストフィールドに pip install コマンドラインオプション(英語)を入力できます。

    • ユーザーのサイトパッケージディレクトリ <path> にインストールする: このチェックボックスが無効になっている場合 (デフォルト)、パッケージは現在のインタープリターのパッケージディレクトリにインストールされます。 チェックボックスが有効になっている場合、パッケージは指定されたディレクトリにインストールされます。 このオプションは conda 環境でのみ使用できます。

  4. パッケージを選択し、「パッケージのインストール 」をクリックします。

  5. エラーメッセージを含むポップアップが表示された場合は、 トラブルシューティングガイドの解決策を参照してください。

conda パッケージリポジトリからパッケージをインストールする

  • 構成された conda 環境で Python インタープリターを選択すると、パッケージ領域のツールバーに Conda パッケージマネージャーを使用する トグルが表示されます。

    Conda パッケージマネージャーを使用する

    このトグルを使用して、conda パッケージリポジトリからパッケージをインストールおよびアップグレードします。 この切り替えは、conda 環境ではデフォルトで有効になっています。

パッケージをアンインストールする

  1. パッケージのリストで、アンインストールするパッケージを選択します。

  2. ツールバーの アンインストール をクリックします。

    Python パッケージのアンインストール

PyCharm は、パッケージのステータスを追跡し、現在インストールされているパッケージのバージョン(列 バージョン )と利用可能な最新バージョン(列 最新バージョン )を表示することで古いバージョンを認識します。 新しいバージョンのパッケージが検出されると、PyCharm は New version is availableアップグレード アイコンでマークします。

デフォルトでは、 最新バージョン 列には安定したバージョンのパッケージのみが表示されます。 利用可能な最新バージョンの範囲をプレリリースバージョン(ベータ版リリース候補など )に拡張する場合は、 初期リリースを表示 をクリックします。

ベータ版やリリース候補を含む最新の利用可能なバージョンを表示する

アップグレードパッケージ

  1. パッケージのリストで、アップグレードするパッケージを選択します。

  2. ツールバーの アップグレード をクリックします。

    Python パッケージのアップグレード

    選択したパッケージは、利用可能な最新バージョンにアップグレードされます。

  3. OK をクリックしてアップグレードを完了します。

コマンドラインからパッケージをインストールする(英語)ことに慣れている場合は、 ターミナルを使用してワークフローを進めることができます。

インストール済みパッケージを再利用する

2026 年 6 月 1 日