PyCharm 2026.1 Help

Git リポジトリのセットアップ

既存の Git リポジトリを クローンするか、 既存のプロジェクトを Git バージョン管理下に置くと、PyCharm はコンピューターに Git がインストールされているか自動的に検出します。 IDE が Git 実行可能ファイルを見つけられない場合、それをダウンロードすることを提案します。

PyCharm は、 Windows 10 バージョン 2004 で利用可能な Linux 用の Windows Subsystem 2(WSL2)の Git をサポートします。

Git が Windows にインストールされていない場合、PyCharm は WSL 内で Git を検索し、そこから使用します。 また、 \\wsl$ パスを使用して開かれるプロジェクトについて、PyCharm は自動的に WSL の Git に切り替えます。

WSL から Git を使用するように PyCharm を手動で構成する必要がある場合は、 バージョン管理 | Git 設定ページ  Ctrl+Alt+S へ進み、 Git 実行可能ファイルのパス フィールドの 閲覧 アイコンをクリックし、 \wsl$ パス(例: \\wsl$\debian\usr\bin\git )から WSL の Git を選択してください。

リモートホストからプロジェクトをチェックアウトする (git クローン)

PyCharm を使うと既存のリポジトリをチェックアウト (Git 用語で クローン) して、ダウンロードしたデータに基づいて新しいプロジェクトを作成できます。

  1. Git リポジトリのクローン作成を始めるには、次のいずれかを実行してください:

    • バージョン管理統合がすでに有効になっている場合は、 Git | クローン に進みます。

    • バージョン管理統合がまだ有効になっていない場合は、 VCS | バージョン管理から取得 に進みます。

      あるいは、 ファイル | 新規 | バージョン管理からプロジェクト に進みます。

    • 現在プロジェクトが開いていない場合は、 ようこそ 画面の左側のペインで クローン をクリックします。

  2. リポジトリのクローン ダイアログで、クローンを作成するリモートリポジトリの URL を指定するか、左側で VCS ホスティングサービスの 1 つを選択します。

    選択したホスティングサービスにすでにログインしている場合は、補完により複製できる利用可能なリポジトリのリストが表示されます。

    GitHub からプロジェクトを取得する

    限定された履歴で 浅いクローン(英語)を実行する場合は、 履歴が切り捨てられた浅いクローン チェックボックスを選択し、クローンするコミットの数を指定します。

    メインメニューで Git | 浅いリポジトリ を選択すると、後で残りの履歴を取得できます。

  3. クローン をクリックしてください。 複製したソースに基づいてプロジェクトを作成する場合は、確認ダイアログで はい をクリックします。 Git ルートマッピングは、プロジェクトのルートディレクトリに自動的に設定されます。

    プロジェクトに サブモジュール(英語)が含まれている場合、それらも複製され、プロジェクトルートとして自動的に登録されます。

  4. プロジェクト '<project_name>' を信頼して開きますか ? プロジェクトセキュリティダイアログで、プロジェクトを開く方法を選択します: プロジェクトを信頼 または セーフモードでプレビュー

既存のプロジェクトを Git バージョン管理下に置く

既存のプロジェクトソースに基づいてローカル Git リポジトリを作成できます。

project 全体を 1 つの Git リポジトリに関連付けます

  1. Git 管理下に入れたい project を開きます。

  2. Alt+` を押して VCS 操作のポップアップ​ を開き、 バージョン管理連携を有効化 を選択します。

    あるいは、 VCS | VCS 連携を有効にする に進みます。

  3. バージョン管理システムとして Git​​サポート を選択し、 OK をクリックします。

    プロジェクト全体が単一の Git ディレクトリに関連付けられます。 その後、 Git で追跡したいファイルをローカルリポジトリに追加します

  4. VCS 統合を有効にすると、PyCharm により VCS を介してプロジェクト設定ファイルを共有するかどうかが確認されます。 常に追加 を選択すると、PyCharm で作業する他のリポジトリユーザーとプロジェクト設定を同期できます。

    設定ファイルの扱い方を選択するよう促す通知

プロジェクト内のさまざまなディレクトリをさまざまな Git リポジトリに関連付ける

  1. Git に置きたいディレクトリを開きます。

  2. メインメニューで VCS | Git リポジトリの作成 へ移動します。

  3. 表示されたダイアログで、新しい Git リポジトリを作成するディレクトリを指定します。

    Git は外部パスをサポートしていないため、プロジェクトルートの外にあるディレクトリを選択した場合は、リポジトリを作成するフォルダーにもプロジェクトルートが含まれていることを確認してください。

  4. project 構造内に複数の Git リポジトリを作成する場合は、各ディレクトリに対して前の手順を繰り返してください。

プロジェクトの Git リポジトリを初期化した後、プロジェクトファイルをリポジトリに追加する必要があります。

ローカルリポジトリにファイルを追加する

  1. コミット ツールウィンドウ(Alt+0 )で、 バージョン管理外ファイル ノードを展開します。

  2. Git または変更リスト全体に追加するファイルを選択し、 Ctrl+Alt+A を押すか、コンテキストメニューから VCS に追加 を選択します。

    Project ツールウィンドウ(Alt+1 )からローカル Git リポジトリにファイルを追加することもできます。追加するファイルを選択し、 Ctrl+Alt+A を押すか、コンテキストメニューから Git | 追加 を選択します。

project で Git 統合が有効になっている場合、PyCharm は新規作成した各ファイルを、たとえ PyCharm の外部から追加された場合でも、Git に追加することを提案します。 この動作は、 バージョン管理 | 確認 設定ページ Ctrl+Alt+S で変更できます。 特定のファイルを常にバージョン管理しないままにしたい場合は、 無視できます。

バージョン管理からファイルを除外する (無視)

特定のファイルをバージョン管理しないでおく必要がある場合があります。 これらには、VCS 管理ファイル、ユーティリティのアーティファクト、バックアップコピーなどがあります。 PyCharm でファイルを無視でき、IDE はそれらを Git へ追加することを提案せず、無視されたものとしてハイライトします。

無視できるのは、 バージョン管理されていないファイル、つまり バージョン管理外ファイル 変更リストにあるファイルのみです。 ファイルが Git に追加されてコミットされていない場合は、 コミット ウィンドウでファイルを右クリックし、 ロールバック を選択できます。

Git では、無視するファイルパターンを次の 2 種類の構成ファイルでリストできます:

  • .git/info/exclude ファイル。

    このファイルにリストされているパターンは、リポジトリのローカルコピーにのみ適用されます。

    このファイルは、Git リポジトリを初期化またはチェックアウトすると自動的に作成されます。

  • VCS ルートディレクトリとそのサブディレクトリにある 1 つ以上の .gitignore ファイル。

    これらのファイルはリポジトリにチェックインされるため、ファイル内の無視パターンをチーム全体が利用できるようになります。 無視されたファイルパターンを保存する最も一般的な場所です。

    VCS ルートディレクトリに .gitignore ファイルがない場合、 Project ツールウィンドウの任意の場所を右クリックし、 新規 | ファイル を選択して、 新規ファイル ダイアログに .gitignore と入力します。

ファイルを .gitignore または .git/info/exclude に追加する

  1. 無視したいファイルのために使用する Git 構成ファイルの種類 を決定します。 疑わしい場合は、 .gitignore を使用してください。

  2. コミット ウィンドウまたは Project ツールウィンドウ (Alt+1) で、無視したいバージョン管理されていないファイルまたはフォルダーを探します。 これらのビューのファイルの色はファイルの状態を識別できます。

  3. 選択項目を右クリックし、 Git | .gitignore に追加する または Git | .git/info/exclude に追加 を選択します。

    これらのビューのファイルの色は、ファイルのステータスを判別するのに役立ちます。

特定のパターンまたはタイプによってファイルを除外する必要がある場合は、 .gitignore または .git/info/exclude ファイルを直接編集できます。 .gitignore パターンフォーマット(英語)を参照してください。

リモートリポジトリを追加する

ローカルソースに基づいて Git リポジトリを作成した場合は、コードベース全体をローカルに保存するリスクを排除するだけでなく、Git プロジェクトで共同作業できるようにリモートリポジトリを追加する必要があります。 作業を共有し、そこからデータを 取得して 、他のコントリビューターが行った変更をローカルリポジトリバージョンに統合する必要がある場合は、変更をリモートリポジトリに プッシュします

たとえば、 GitHub(英語) から リモート Git リポジトリを複製した場合、リモートは自動的に構成され、それと 同期するときに指定する必要はありません。 Git がクローン元のリモートに付けるデフォルト名は、 origin です。

リモートを定義する

  1. BitbucketGitHub 、または GitLab など、いずれかの Git ホスティングに空のリポジトリを作成します。 PyCharm から離れずに GitHub や GitLab でリポジトリを作成できます。詳しくは、 プロジェクトを GitHub で共有 および プロジェクトを GitLab で共有 を参照してください。

  2. メインメニューから Git | プッシュ を選択してコミットをプッシュする準備ができたら、 プッシュ ダイアログを起動するか、 Ctrl+Shift+K をプッシュします。

  3. 開いたダイアログで、リモートの名前とホストする URL を指定します。

    Fetch remote オプションを選択すると、ブランチリストとコミット履歴もすぐに 取得されます

2 台目のリモートを追加

場合によっては、2 番目のリモートリポジトリも追加する必要があります。 これは、たとえば、書き込みアクセス権を持たないリポジトリのクローンを作成し、元のプロジェクトの独自の フォークに変更をプッシュする場合に便利です。 もう 1 つの一般的なシナリオは、他人のプロジェクトフォークである独自のリポジトリのクローンを作成し、元のプロジェクトと同期してそこから変更を取得する必要があるというものです。

  1. メインメニューで、 Git | リモートの管理 に移動します。 Git リモート ダイアログが開きます。

  2. ツールバーの 追加 add ボタンをクリックするか、 Alt+Insert を押してください。

  3. 表示されたダイアログで、リモートの名前と URL を指定し、 OK をクリックします。

このビデオからさらに詳しく学ぶ:

Git リモートのパスワードを設定する

リモート Git リポジトリと対話するたびに(たとえば、 プル更新 、または プッシュ操作中)、許可が必要です。 PyCharm にパスワードを記憶させるように構成できるため、認証が必要な際に毎回資格情報を入力する必要がありません。

パスワードポリシーを設定する

  1. 設定 ダイアログ Ctrl+Alt+S で、左側の 外観 と動作 | システム設定 | パスワード を選択します。

  2. PyCharm で Git リモートリポジトリのパスワードをどのように処理するかを選択してください:

    • ネイティブキーチェーンを使用する: ネイティブのキーチェーンを使用してパスワードを保存するには、このオプションを選択します。 この設定は、macOS および Linux でのみ使用できます。

    • KeePass を使用する: KeePass パスワードマネージャー(英語)を使用してパスワードを保存するには、このオプションを選択します。 KeePass パスワードマネージャー を使用する場合、個別のパスワードを保存するファイルにアクセスするためにマスターパスワードが使用されます。 PyCharm がパスワードを記憶すると、パスワードデータベースにアクセスする必要がない限り、パスワードを要求されません。 c.kdbx ファイルへのアクセスに使用するパスワードを MasterPassword フィールドに入力します。

      データベース フィールドで、 c.kdbx ファイルのデフォルトの場所を変更することができます。

      c.kdbx ファイルをインポートするには、 設定アイコン をクリックしてドロップダウンメニューから インポート を選択するか、 参照ボタン をクリックしてパスワードを含むローカルファイルへのパスを指定します。

      既存のパスワードをデータベースから削除する場合は、 クリア を選択します。

    • 保存せずに再起動後にパスワードを忘れる: PyCharm を閉じた後にパスワードをリセットしたい場合は、このオプションを選択してください。

2026 年 6 月 1 日