PyCharm 2020.2 ヘルプ

Git リポジトリをセットアップする

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

PyCharm は、Windows 10 バージョン 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 から Git を選択します(例: \\wsl$\debian\usr\bin\git)。

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

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

  1. メインメニューから VCS | バージョン管理から取得を選択するか、現在プロジェクトが開いていない場合は、ようこそ画面でバージョン管理から取得をクリックします。

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

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

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

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

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

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

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

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

  2. VCS 操作のポップアップ Alt+` またはメイン VCS メニューからバージョン管理統合を使用可能にするを選択します。

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

  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. ローカルの変更ビューで、バージョン管理外のファイルノードを展開します。
  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 パターンフォーマット(英語)を参照

プロジェクトの確認

PyCharm を使用すると、プロジェクトのリポジトリバージョンと比較したローカルの作業コピーのステータスを確認できます。特定の色を使用して、変更されたファイル、VCS に追加された新しいファイル、Git によって追跡されていないファイルを確認できます。

ローカルの変更ビューを開きます。

  • デフォルト変更リストには、リモートリポジトリ(青色で強調表示されている)と最後に同期された後に変更されたすべてのファイルと、VCS に追加されていますがまだコミットされていない(緑色で強調表示されている)

  • バージョン管理外のファイル変更リストには、あなたのプロジェクトに追加されたが、Git によって追跡されていないすべてのファイルが表示されます。

変更リストの詳細については、変更を異なる変更リストにグループ化するを参照してください。

エディターでファイルへの変更を追跡する

エディターでファイルを変更するときに、ファイルへの変更を追跡することもできます。すべての変更は、変更された行の横のガターに表示される変更マーカーで強調表示され、最後にリポジトリと同期してから導入された変更のタイプを示します。リポジトリへの変更をコミットすると、変更マーカーが消えます。

テキストに加えた変更は色分けされています。

  • marker for a newly added line ラインを追加しました。

  • marker for a modified line ラインが変更されました。

行を削除すると、次のマーカーがガターに表示されます:the deleted line marker

変更マーカー上にマウスカーソルを置いてクリックすると表示されるツールバーを使用して変更を管理できます。ツールバーは、変更された行の前の内容を示すフレームとともに表示されます。

Changes toolbar

the Revert icon をクリックして変更をロールバックし、the Show diff iconをクリックして現在の行の現在のバージョンとリポジトリバージョンの違いを確認できます。

ファイル全体を元に戻す代わりに、このポップアップの内容の一部をコピーしてエディターに貼り付けることができます。

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

Git プロジェクトでコラボレーションできるようにするには、データをフェッチし、作業を共有する必要があるときにプッシュするリモートリポジトリを構成する必要があります。

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

ただし、ローカルソースに基づいて Git リポジトリ作成した場合は、他のコントリビューターが変更をプッシュできるように、また作業の結果を共有できるように、リモートリポジトリを追加する必要があります。

リモートを定義する

  1. Bitbucket(英語)GitHub(英語) などの Git ホスティングに空のリポジトリを作成します。

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

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

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

2 台目のリモートを追加

  1. メインメニューから VCS | Git | リモートを選択します。Git リモートダイアログが開きます。

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

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


リモートを編集するには(たとえば、複製した元のプロジェクトの名前を変更する)、Git リモートダイアログでリモートを選択し、ツールバーの編集 edit ボタンをクリックするか、Enter を押します。

無効になったリポジトリを削除するには、Git リモートダイアログでそのリポジトリを選択し、ツールバーの除去 remove ボタンをクリックするか、Alt+Delete を押します。

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

最終更新日 :

関連ページ:

変更のコミットダイアログ

このダイアログを使用して、選択した変更リストからリポジトリに変更をコミット(チェックイン)を実行し、オプションでパッチファイルを作成します。PyCharm バージョン 2020.1 以降、非モーダルコミットインターフェースに切り替えることができます。設定 / 環境設定ダイアログで をバージョン...

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

新しいファイルを Git リポジトリに追加するか、すでに Git バージョン管理下にあるファイルを変更して、現在の状態に満足したら、作業の結果を共有できます。これには、ローカルでコミットしてリポジトリのスナップショットをプロジェクト履歴に記録し、リモートリポジトリにプッシュして他のユーザーが利用でき...

リモート Git リポジトリと同期する (フェッチ、プル、更新)

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

GitHub 上のプロジェクトに貢献する

GitHub でホストされているプロジェクトに貢献したいと思っていて、直接的にプッシュできない場合は、以下のワークフローを実行してください:貢献したいプロジェクトのフォークを作成します。このフォークをクローンしてローカルリポジトリを作成します。元のプロジェクトのコピーに変更を加え、コミットしてプッシ...