プロジェクトへの変更のコミットやレビュー

コミットについて

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

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

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

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

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

新しいブランチを作成するか、ツールバーの Current Branch をクリックして一覧からブランチを選択し、既存のブランチを選択します。

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

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

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

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

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

差分オプションのメニュー

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

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

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

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

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

部分的なコミットの作成方法

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

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

ファイルで選択解除された行

変更の廃棄

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

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

複数のファイルの変更を破棄する

変更されたファイルのリスト中で、最後のコミット以降の変更を破棄したいファイルオを選択してください。複数のファイルを選択するには、shift をクリックして、変更を破棄したいファイルの範囲をクリックしてください。 1. [Discard Changes] (変更の破棄) または [Discard Selected Changes] (選択された変更の破棄) をクリックして、1 つ以上のファイルに対する変更を破棄するか、 [Discard All Changes] (すべての変更を破棄) をクリックして最後のコミット以降のすべてのファイルに対する変更を破棄してください。

1. 変更を確認するには、影響を受けるファイルを確認して [Discard Changes] (変更を破棄) をクリックしてください。

複数の行の変更を破棄する

未コミットの変更した複数の行を破棄できます。

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

追加した単一行を破棄するには、変更した行のリストで、破棄する行を右クリックして、 [Discard added line](追加した 1 行の破棄) を選択します。

確認ダイアログ内の [Discard single line]

変更した行のグループを破棄するには、破棄する行の行番号の右側にある垂直のバーを右クリックして、 Discard added lines を選択します。

確認ダイアログ内の [Discard a group of added lines]

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

コミットに含めたい変更を決めたら、コミットメッセージを入力して変更をプッシュします。コミットで共同作業した場合、コミットに 1 人以上の作者を追加できます。

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

変更のリストの下のSummary（サマリー）フィールドに短く分かりやすいコミットメッセージを入力してください。 Description（説明）フィールドに、変更に関するさらに詳しい情報を追加することもできます。
オプションとして、コミットに別の作者を追加するには、共作者を追加するアイコンをクリックし、追加するユーザ名を入力します。

1. [Description](説明) フィールドの下で、 [Commit to BRANCH] (ブランチにコミット) をクリックしてください。
コミットしようとしているブランチが保護されている場合、Desktopは警告します。
```
- 変更を移動するには、 **[switch branches](ブランチの切り替え)** をクリックします。
- 保護されたブランチに変更をコミットするには、 **[Commit to _BRANCH_](<ブランチ名> にコミット)** をクリックします。
```
保護されたブランチの詳細については、「保護されたブランチについて」を参照してください。

1. [Push origin](オリジンへプッシュ) をクリックして、ローカルの変更をリモートリポジトリにプッシュします。
操作しているブランチに基づいた pull request がある場合は、GitHub Desktop には、その pull request に対して実行されたチェックのステータスが表示されます。詳しくは、GitHub Desktop でのチェックの表示と再実行に関するページをご覧ください。

現在のブランチに対して pull request が作成されていない場合は、作成するオプションが GitHub Desktop から提供されます。詳細については、「issue もしくは pull request の作成」を参照してください。