Gitが、おもしろいほどわかる基本の使い方33

 変更をコミットする(前編)

　実際に開発が始まると、新しいファイルを作成したり、既存のファイルの内容を書き替えたり、不要なファイルを削除したり、ファイル名を変更したり……さまざまな編集作業が行われていきます。そうした変更にメッセージをつけてリポジトリに登録する操作を「コミット」（commit）といいます。

　「1-05 コミットする手順を覚える」（本書P.028を参照）では、まずはコミットしてみることを目的に、操作方法を駆け足で説明しましたが、ここでもう少し詳しく見ていきましょう。

　リポジトリ内では、コミットを行うことで、変更の履歴が時系列につながった形で記録されていきます。利用者は、これまでに、どのファイルのどの箇所が変更されたのか、またその変更はいつ誰が行ったのかなどを知ることができます。また、コミット単位で、過去にさかのぼってファイルを取得したり、現状のファイルをある時点まで戻したりすることもできます。

　このようなコミットの履歴は、SourceTreeでは「ログ」タブに表示されます【図1】【図2】 。

「1-07 本書のデモリポジトリを利用する」でクローンした本書のデモリポジトリには、 すでにいくつかのコミットがあります。

Mac版SourceTreeでは「ログ」タブは存在しません。なお、メインウィンドウが 開いていない場合は、リポジトリブラウザで目的のリポジトリ名をダブルクリックします。

まず、コミットはステージに追加（add）→コミットという2段階で行うということを覚えておきましょう【図3】 。どうして2段階なのかは後述しますので、早速実際にコミットを行ってみましょう。

<title>ミクロネシアプレミアムリゾートホテル</title>

<title>ハワイアンプレミアムリゾートホテル</title>

【MEMO】1コミット先行（「1 ahead」）
前ページの手順⑧の図を見ると、行ったコミットに「1コミット先行」（Macでは「1 ahead」）と表示されています。これはクローン元であるBitbucketに対して1コミット先行したということを示しています。そのすぐ下に、origin/masterとorigin/HEADという表示がありますが、こちらはBitbucket 上のブランチの最新の位置を示しています。このように、SourceTreeでは、ローカル（自分のPC）とリモート（今回はBitbucket）のそれぞれのコミットの状態を簡単に一覧してみることができます。

　ファイルを編集していく過程で、どのタイミングでコミットするのが正しいのか、さまざまな考え方がありますが、基本的にはひとつの作業を終えるごとにコミットすることが望ましいでしょう【図4】 。これは、コミットごとの作業が明確になるとともに、もしコミットした内容が間違っていた場合にも修正を行いやすくするという意味があります。コミット単位でしかファイルの復元ができないため、多くの作業を同時にコミットすると、それらをすべて戻さないといけないケースも発生してしまいます。

　とくに、同時に複数の人が作業している場合には、より1作業ごとにコミットし、変更情報を共有していくことを心がけましょう。プロジェクト全体の実作業の進捗具合が明確になります。また、メンバー間での作業の重複や、衝突を避けることにもつながります。

　もしプロジェクトにおいて、課題管理ツールなどを利用している場合は、その1課題ごとにコミットを行うということを目安にするとよいでしょう。

【MEMO】ステージの役割
変更したファイルをコミットする前にステージに追加するという作業は不要にも感じられます。では、なぜこの作業を行うように設計されているのでしょうか。これには理由があります。前述した通り、コミットは一作業ごとに行うのが基本ですが、作業を集中して進めた結果、複数の作業を一度に進めてしまうこともあるでしょう。そんなときに、変更されたファイルから1作業ごとにステージにピックアップすることで、1コミットで1作業を実現することができます。

【MEMO】コミットメッセージの内容
コミットには「コミットメッセージ」と呼ばれる、コミットの説明文の記載が必要です。端的で誰が見てもわかりやすいコミットメッセージを記載するように心がけましょう。1コミットで1 作業とも目的が重なりますが、複数の作業を一度に行って「いくつかの修正に対応」などとメッセージをつけてまとめてコミットなどというやり方では、ほかのメンバーは何をどうして変更したのかさっぱりわかりません。せっかくのGit によるバージョン管理の利点が失われてしまいます。