GitHub Desktop でプロジェクトの変更をコミットしてレビューする

コミットについて

編集されたファイルの保存と同様に、コミットは、ブランチにある１つ以上のファイルの変更を記録します。 Gitは、各コミットに次の情報を識別するSHA、またはハッシュと呼ばれる固有のIDを割り当てます。

具体的な変更
変更時間
変更者

コミットするときは、変更を簡潔に説明するコミットメッセージを含める必要があります。コラボレーションしているコミットに共作者を追加することもできます。

GitHub Desktop で作成したコミットが GitHub 上の間違ったアカウントに関連付けられている場合は、GitHub Desktop を使って Git の構成でメールアドレスを更新してください。「GitHub Desktop用のGitの設定方法」をご覧ください、詳しくは。

リポジトリ管理者は、ブランチのルールセットを有効にして、コミット時に特定の規則を実施できます。たとえば、ルールセットでコミットに署名を要求したり、イシュー番号をコミットメッセージの最初に参照するよう要求したりすることができます。 GitHub Desktop は警告を表示し、コミットがルールセットに従わない場合はコミットを拒否します。詳しくは、「ルールセットについて」をご覧ください。

ブランチの選択と変更の実行

       [新しいブランチを作成する](/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)か、ツール バーの **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-branch" aria-label="git-branch" role="img"><path d="M9.5 3.25a2.25 2.25 0 1 1 3 2.122V6A2.5 2.5 0 0 1 10 8.5H6a1 1 0 0 0-1 1v1.128a2.251 2.251 0 1 1-1.5 0V5.372a2.25 2.25 0 1 1 1.5 0v1.836A2.493 2.493 0 0 1 6 7h4a1 1 0 0 0 1-1v-.628A2.25 2.25 0 0 1 9.5 3.25Zm-6 0a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Zm8.25-.75a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5ZM4.25 12a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Z"></path></svg> [Current Branch]** をクリックして一覧からブランチを選択し、既存のブランチを選択します。


       ![[現在のブランチ] ドロップダウン ビューのスクリーンショット。 [Recent Branches] の下にある [my-feature] というブランチがオレンジの枠線で強調表示されています。](/assets/images/help/desktop/select-branch-from-dropdown.png)

Visual Studio Code などの好みのテキストエディターを使って、プロジェクトのファイルに必要な変更を行います。

差分を表示する方法の選択

レビューのニーズに合わせて、GitHub Desktop に差分を表示する方法を変更できます。

差分の表示方法を変更するには、差分ビューの右上隅にあるをクリックします。

差分全体の表示方法を変更するには、[Diff display] で [Unified] または [Split] を選択します。統合ビューでは変更が直線的に表示され、分割ビューでは左側に古い内容が表示されて、右側に新しい内容が表示されます。
空白の変更を非表示にして、より実質的な変更に集中できるようにするには、 Hide Whitespace Changes を選択します。

ファイルの差分ビューのスクリーンショット。オレンジ色の枠線で囲まれた歯車アイコンが展開され、[Whitespace] と [Diff display] の設定が表示されています。

ヒント

差分の表示に使われる既定のタブサイズは 8 です。これは、[Settings] ダイアログの [Appearance] ペインでカスタマイズできます。

ヒント

差分の表示に使われる既定のタブサイズは 8 です。これは、[Options] ダイアログの [Appearance] ペインでカスタマイズできます。

既定で GitHub Desktop に表示されるものより多くのファイルを表示する必要がある場合は、差分を展開できます。

強調表示された変更の上または下の数行を表示するには、行番号の上または下にある矢印をクリックします。
ファイル全体を表示するには、差分ビューで右クリックし、 Expand Whole File をクリックします。

コミットに含める変更の選択方法

テキストエディタでファイルに変更を加えて保存していくと、変更は、GitHub Desktopにも反映されます。

左側のサイドバーにある [変更] タブで次の手順を実行します。

赤いアイコンは、削除されたファイルを示します。
黄色のアイコンは、変更済みファイルを示します。
緑のアイコンは、追加されたファイルを示します。
一時退避された変更にアクセスするには、 Stashed Changes をクリックします。
すべてのファイルのすべての変更を 1 回のコミットに追加するには、リストの上部にあるチェックボックスをオンにしてください。
1 つ以上のファイルのすべての変更を 1 回のコミットに追加するには、含めないファイルの隣のチェックボックスをオフにし、コミットに含めたいファイルだけを残してください。チェックボックスは、ファイルの選択後、Spacebar または Enter キーで切り替えることができます。

部分的なコミットを作成する

1 つのファイルに複数の変更があり、それらの変更の一部のみをコミットに含める場合は、部分的なコミットを作成できます。追加変更やコミットできるように、他の変更はそのまま残ります。これにより、改行の変更をコードや構文の変更から区別するなど、個別で有意義なコミットの作成が可能になります。

変更した行をコミットから除外するには、変更した行を複数クリックして、青色が消えるようにします。青色で強調表示されている行は、コミットに含まれます。

ファイルの差分ビューのスクリーンショット。 "I don't want to include this line" (私はこの行を含めたくありません) の行番号に対応する背景色は青ではなく緑色です。

変更の廃棄

保持する必要がない未コミットの変更がある場合は、変更を破棄できます。これにより、コンピュータ上のファイルから変更が削除されます。複数のファイル内の未コミットの変更をすべて破棄することも、追加した特定の行を破棄することもできます。

破棄した変更は、ゴミ箱内の日付つきのファイルに保存されます。ゴミ箱を空にするまでは、破棄した変更を復元できます。

1つ以上のファイルの変更を破棄する

変更されたファイルのリスト中で、最後のコミット以降の変更を破棄したいファイルオを選択してください。複数のファイルを選択するには、shift をクリックして、変更を破棄したいファイルの範囲をクリックしてください。
[Discard Changes] (変更の破棄) または [Discard Selected Changes] (選択された変更の破棄) をクリックして、1 つ以上のファイルに対する変更を破棄するか、 [Discard All Changes] (すべての変更を破棄) をクリックして最後のコミット以降のすべてのファイルに対する変更を破棄してください。
```
       ![[変更] タブのスクリーンショット。2 つの選択されたファイルが青色で強調表示されています。 コンテキスト メニューで「2つの選択した変更を破棄」にカーソルが置かれています。](/assets/images/help/desktop/discard-changes-mac.png)
```
変更を確認するには、[Confirm Discard Changes] (破棄する変更の確認) ウィンドウで影響を受けるファイルを確認し、 [変更の破棄] をクリックします。

1つ以上の行での変更を破棄する

未コミットの変更行を1行以上破棄できます。

メモ

複数の行を追加および削除する変更グループでは、単一行の破棄は無効になっています。

追加した 1 行を破棄するには、変更した行の一覧で、破棄する行の行番号を右クリックして、 [追加した 1 行の破棄] を選びます。

ファイルの差分ビューのスクリーンショット。コンテキストメニューで「追加された行を破棄」にカーソルが置かれ、青色で強調表示されています。

変更した行のグループを破棄するには、破棄する行の行番号の右側にある垂直のバーを右クリックして、 [追加した複数行の破棄] を選びます。

ファイルの差分ビューのスクリーンショット。行番号の右側にある、細くて濃い青色の線がオレンジ色の枠線で強調表示されています。

コミットメッセージの入力と変更のプッシュ

コミットに含める変更を選択してその結果に満足した後、そのコミットに関する説明を入力して変更をプッシュする必要があります。コミットで共同作業した場合、コミットに 1 人以上の作者を追加できます。

メモ

デフォルトでは、GitHub Desktopは作成したタグを関連するコミットと共にリポジトリにプッシュします。詳しくは、「GitHub Desktop でのタグの管理」をご覧ください。

変更一覧の下部にあるプロフィール画像の横で、コミットについて説明します。
- GitHub Copilot にアクセスできる場合、行った変更に基づいてコミットメッセージと詳細を自動的に作成できます。をクリックします。
- 別のコミットメッセージを再生成したい場合は、をもう一度クリックして、新しい提案を生成します。
- または、[Summary] フィールドに簡潔でわかりやすい独自のコミットメッセージを入力します。変更に関するさらに詳しい情報を [Description] フィールドに追加することもできます。

オプションとして、コミットに別の作者を追加するには、共作者を追加するアイコンをクリックし、追加するユーザ名を入力します。

       ![[Changes] タブのスクリーンショット。[Description] フィールドの隅にある、共同作成者を追加するためのアイコンが、オレンジ色の枠線で囲まれています。](/assets/images/help/desktop/add-co-author-commit.png)

[説明] フィールドの下にある [<ブランチ> にコミット] をクリックします。

ヒント

リポジトリに事前コミットまたはコミットメッセージフックがある場合は、コミット時に自動的に実行されます。特定のコミットのフックをバイパスするには、コミットメッセージフィールドの横にあるをクリックし、[ コミットフックのバイパス] を選択します。詳しくは、「GitHub Desktop での Git フックの操作」をご覧ください。
コミットしようとしているブランチが保護されている場合、Desktopは警告します。
- 変更を反映するには、ブランチを切り替える をクリックします。
- 保護されたブランチに変更をコミットするには、 [<ブランチ名> にコミット] をクリックします。
保護されたブランチについて詳しくは、「保護されたブランチについて」をご覧ください。
ローカルの変更をリモートリポジトリにプッシュするには、リポジトリバーの [Push origin] (オリジンへプッシュ) をクリックします。
操作しているブランチに基づいた pull request がある場合は、GitHub Desktop のリポジトリバーの [現在のブランチ] の横には、その pull request に対して実行されたチェックのステータスが表示されます。チェックについて詳しくは、「GitHub Desktop でのチェックの表示と再実行」をご覧ください。

現在のブランチに対して pull request が作成されていない場合は、変更をプレビューして作成するオプションが GitHub Desktop に表示されます。詳しくは、「GitHub Desktop からの issue または pull request の作成」をご覧ください。

コミット履歴の管理

コミットを元に戻す、またはコミット履歴を変更する必要がある場合 (レビュー担当者にわかりやすい変更にする場合)、GitHub Desktop には、コミット履歴を管理するための多数のオプションが用意されています。詳しくは、「GitHub Desktop 内でコミットを管理するオプション」をご覧ください。

参考資料

        [AUTOTITLE](/get-started/using-git)

        [AUTOTITLE](/desktop/making-changes-in-a-branch/working-with-git-hooks-in-github-desktop)