PyCharm 2024.1 ヘルプ

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

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

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

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

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

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

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

  1. Git リポジトリのクローン作成を開始するには、次のいずれかを実行します。

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

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

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

    • 現在開いているプロジェクトがない場合は、ウェルカム画面で VCS から取得をクリックします。

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

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

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

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

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

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

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

プロジェクト全体を単一の Git リポジトリに関連付けます

  1. Git の中に入れたいプロジェクトを開きます。

  2. Alt+` を押して VCS 操作のポップアップを開き、VCS 連携を有効にするを選択します。

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

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

    プロジェクト全体が単一の Git ディレクトリに関連付けられるため、各ファイルを Git ディレクトリに個別に追加する必要はありません。

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

    Notification prompting to select how to treat configuration files

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

  1. Git の中に入れたいプロジェクトを開きます。

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

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

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

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

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

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

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

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

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

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

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

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

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

Git では、2 種類の構成ファイルで無視されたファイルパターンをリストできます。

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

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

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

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

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

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

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

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

  2. 変更ビューまたはプロジェクトツールウィンドウで、無視するバージョン管理されていないファイルまたはフォルダーを見つけます。これらのビューのファイルの色は、ファイルのステータスを識別できます。

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

    これらのビューのファイルの色は、ファイルのステータスを識別できます。

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

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

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

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

リモートを定義する

  1. Bitbucket(英語)GitHub(英語) などの Git ホスティングに空のリポジトリを作成します。PyCharm を移動せずに GitHub にリポジトリを作成できます。GitHub でプロジェクトを共有するを参照してください。

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

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

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 ファイルをインポートするには、the Settings icon をクリックしてドロップダウンメニューからインポートを選択するか、the Browse button をクリックしてパスワードを含むローカルファイルへのパスを指定します。

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

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

関連ページ:

プロジェクトのセキュリティ

潜在的なセキュリティリスクを防ぐために、PyCharm では、プロジェクトのソースがわからない場合にプロジェクトを開く方法を決定できます。PyCharm は、オープニングプロセス中に実行されるタスクまたは構成について警告し、信頼できるソースを構成できるようにします。不明なソースからプロジェクトを開く:プロジェクトを開くと、PyCharm を使用すると、未知ソースコードを含むプロジェクトの処理方法をすぐに決定できます。プロジェクトを初めて開くたびに、IDE にプロジェクトを信頼ダイアログが表示さ...

Git リポジトリに変更をコミットしてプッシュする

Git リポジトリに新しいファイルを追加するか、すでに Git バージョン管理下にあるファイルを変更し、現在の状態に満足したら、作業の結果を共有できます。これには、ローカルにコミットしてリポジトリのスナップショットをプロジェクト履歴に記録し、次にリモートリポジトリにプッシュして他のユーザーが使用できるようにすることが含まれます。Git ユーザー名を設定する Git は、コミットを ID に関連付けるために、ユーザー名を知っている必要があります。ユーザー名を設定していない場合、PyCharm は、最...

ファイルステータスのハイライト

ファイルステータス:プロジェクトツールウィンドウでは、ファイルをさまざまな色で表示でき、コード分析の結果やバージョン管理状態などに応じて、エディタータブをハイライトできます。設定のバージョン管理 | ファイルステータスの色ページで VCS ファイルのステータスの色を設定できます。一部でリストのデフォルトのファイルステータスの色と意味下表のカラースキーム。#0A7700 追加済みアクティブな変更リストのファイルは、リポジトリへの追加がスケジュールされています。#0EAA00 非アクティブ変更リスト...

リモート Git リポジトリと同期する

変更をアップストリームにプッシュして作業結果を共有する前に、リモートリポジトリと同期して、プロジェクトのローカルコピーが最新であることを確認する必要があります。これを行うには、次のいずれかの方法があります: 変更のフェッチ、変更のプル、プロジェクトの更新 Git ブランチポップアップは、ブランチにまだフェッチされていない受信コミットがあるかどうかを示します。変更のフェッチ:アップストリームから変更をフェッチすると、リモートリポジトリと最後に同期してから行われたコミットからのすべての新しいデータがロー...

GitHub でホストされているプロジェクトを管理する

プロジェクトをチェックアウトする (クローン):PyCharm から直接貢献したいリポジトリのクローンを作成し、それに基づいて新しいプロジェクトを作成できます。メインメニューで、に移動します。Git メニューが使用できない場合は、を選択します。バージョン管理から取得ダイアログで、左側の GitHub を選択します。次のいずれかを実行して、GitHub にログインします。トークンがある場合は、トークンを使用するをクリックし、トークンをトークンフィールドに貼り付けて、ログインをクリックします。それ以外の場...

ログタブ

このタブは、バージョン管理に Git または Mercurial を使用している場合にのみ使用できます。このタブには、すべてのローカルおよびリモートブランチ、およびすべてのブランチ、特定のブランチまたはリポジトリにコミットされたすべての変更が表示されます。タブには次のペインが含まれます。ブランチペインは左側にあり、すべてのローカルおよびリモートブランチを表示します。このペインから、ブランチを切り替えたり、新しいブランチを作成したり、不要なものを削除したり、ブランチでログをフィルター処理したりできます。コ...