PyCharm 2024.3 ヘルプ

タグを使用して特定の Git コミットをマークする

Git を使用すると、コミットにタグを付けて、プロジェクト履歴の特定のポイントをマークし、将来参照できるようにすることができます。例: リリーススナップショットをキャプチャーするためにブランチを作成する代わりに、リリースバージョンに対応するコミットにタグを付けることができます。

PyCharm では、Git ブランチポップアップでタグの操作を実行できます。これを呼び出すには、メインウィンドウのヘッダーで、現在チェックアウトされているブランチの名前の Git ウィジェットをクリックします。

Tags node in the branches popup

Git ツールウィンドウ Alt+9ブランチペインでもタグを管理できます。

Branches pane

コミットにタグを割り当てる

  1. Git ツールウィンドウ Alt+9 を開き、ログタブに切り替えます。

  2. 目的のコミットを見つけて右クリックし、コンテキストメニューから新規タグを選択します。

  3. 新しいタグの名前を入力し、OK をクリックします。タグは、Git ツールウィンドウ Alt+9ログタブに表示されます。

    Tagged commit

アノテーション付きタグをコミットに割り当てる

アノテーション付きタグのメタデータには、作成したユーザーの名前が含まれているため、誰がタグを配置したかを確認できます。

  1. メインメニューで、Git | 新規タグに移動します。

  2. 開いているタグダイアログで、Git ルートで、コミットにタグを付けるローカルリポジトリへのパスを選択し、新しいタグの名前を指定します。

  3. コミットフィールドに、タグを付けるコミットを指定します。コミットハッシュを入力するか、式 (例: <branch>~<number of commits backwards between the latest commit (HEAD) and the required commit>) を使用できます。詳細については、Git コミットの命名(英語)規則を参照してください。

  4. メッセージフィールドにコメントを入力して、アノテーション付きタグを作成します(空の場合、通常のタグが作成されます)。

  5. タグの作成をクリックします。

既存のタグを再割り当てする

間違ったコミットにタグを置き、それを再割り当てする場合(たとえば、リリースバージョンのコミットを示す場合)は、次のようにします。

  1. メインメニューで、Git | 新規タグに移動します。

  2. タグダイアログで、タグ名フィールドに、再割り当てする既存のタグの名前を指定します。

  3. 強制オプションを選択してください。

  4. コミット」フィールドで、タグを移動するコミットを指定し、「タグの作成」をクリックします。

タグ付きコミットに移動する

  1. Git ツールウィンドウ Alt+9 を開き、ログタブに切り替えます。

  2. ツールバーのハッシュ / ブランチ / タグへジャンプアイコン をクリックするか、Ctrl+F を押します。

    Go to Hash/Branch/Tag icon
  3. タグ名を入力し(コード補完は入力時にタグ名を提案します)、Enter を押します。

タグ付きコミットを確認する

タグ付きのリリースバージョンに対応するコミットをマークしたとし、その時点でプロジェクトのスナップショットを確認したいとします。タグ付きコミットをチェックアウトすることで、これを行うことができます。次のいずれかを実行します。

  • チェックアウトするタグ付きコミットを見つけて右クリックし、コンテキストメニューからリビジョンのチェックアウトを選択します。

  • Git ツールウィンドウ Alt+9 で、タグノードを開き、必要なタグを選択して、コンテキストメニューのアクションリストからチェックアウトを選択します。

  • ブランチポップアップを呼び出すをクリックし、タグまたはリビジョンのチェックアウトをクリックしてタグ名を入力します(PyCharm は入力時に一致するタグとリビジョンのリストを提供します)。

  • ブランチポップアップを呼び出すタグノードを開き、必要なタグを選択して、コンテキストメニューのアクションリストからチェックアウトを選択します。

この操作により、HEAD(英語)切り離さ(英語)れることに注意してください。これは、ブランチを使用しなくなったことを意味します。このスナップショットは、インスペクションおよび実験に使用できます。ただし、このスナップショットの上に変更をコミットする場合は、ブランチ作成する必要があります。

タグをプッシュする

デフォルトでは、push 操作を実行すると、タグはリモートリポジトリに送信されません。

特定のタグをプッシュするには、ブランチポップアップまたは Git ツールウィンドウ Alt+9 を呼び出し、タグノードを開いて必要なタグを選択し、コンテキストメニューのアクションリストから原点にプッシュを選択します。

コミットと一緒に複数のタグをプッシュするには:

  1. コミットのプッシュダイアログで、左下隅にあるタグのプッシュチェックボックスを選択します。

    Push Tags option in the Push Commits dialogue
  2. ドロップダウンメニューで、プッシュするタグを選択します。

    • 選択したブランチに属していないタグ(push --tags に相当)を含む、すべてのタグをプッシュしたい場合は、すべてを選択します。

    • プッシュしようとしている、選択したブランチに属するタグのみをプッシュする場合は、現在のブランチを選択します ( push --follow-tags と同等)。

  3. プッシュをクリックします。

タグを削除する

  • タグ付けされたコミットを見つけて右クリックし、コンテキストメニューからタグ <tag_name> | 削除を選択します。

  • Git ツールウィンドウ Alt+9 で、タグノードを開き、必要なタグを選択して、コンテキストメニューのアクションリストから削除を選択します。

  • ブランチポップアップを呼び出すタグノードを開き、必要なタグを選択して、コンテキストメニューのアクションリストから削除を選択します。

関連ページ:

Git ブランチの管理

Git では、ブランチは、たとえば機能の作業が必要な場合や、リリースのためにコードベースの特定の状態を固定する必要がある場合などに、メインの開発ラインから分岐できるようにする強力なメカニズムです。PyCharm では、ブランチによるすべての操作は Git ブランチポップアップで実行されます。これを呼び出すには、メインウィンドウのヘッダーで、現在チェックアウトされているブランチの名前を持つ Git ウィジェットをクリックします。Git ツールウィンドウのブランチペインで、ブランチを管理し、複数のブラン...

ログタブ

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

コード補完

このセクションでは、コーディングプロセスのスピードアップを可能にするコンテキスト対応コード補完のさまざまなテクニックについて説明します。基本補完:基本コード補完は、可視性スコープ内のクラス、メソッド、キーワードの名前を補完するのに役立ちます。コード補完を呼び出すと、PyCharm はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します (提案にはライブテンプレートも含まれます)。基本コード補完がフィールド、パラメーター、変数宣言の一部に適用されている場合、PyCharm...

Git リポジトリの変更を元に戻す

コミットされていない変更を元に戻すコミットする前に、ローカルで行った変更をいつでも元に戻すことができます。コミットツールウィンドウで、元に戻すファイルを 1 つ以上選択し、コンテキストメニューからロールバックを選択するか、を押します。最後のコミット以降に選択したファイルに加えられたすべての変更は破棄され、アクティブな変更リストから消えます。ファイルのステージングを解除するデフォルトでは、PyCharm は、変更されたファイルが自動的にステージングされる変更リストの概念を使用します。ファイルが...