Gitでブランチを切ってマージするまでを通しでやってみよう(総合演習)

まずgit initです。そのフォルダを「Gitが見張る場所」に変えるコマンドで、.gitという隠しフォルダが作られます。ここに履歴がすべて入ります。

次がgit status。Gitを使ううえで最も打つことになるコマンドです。迷ったらこれを打つ、というくらい基本で、「いまどのブランチにいて、何が変更されていて、何がコミット待ちか」を教えてくれます。

結果を見ると、index.html・style.css・app.jsの3つがmodified(変更済み)になっています。この演習では、あなたがエディタでこの3つを編集し終えた直後、という想定で始まります(疑似ターミナルにはエディタが無いため、最初から変更済みの状態にしてあります)。

大事なのはGitはまだ何も記録していないということです。変更を見つけてはいるものの、履歴に残すかどうかはこれからあなたが決めます。

ここがこの演習の肝です。変更をいきなりmainにコミットしてもGitとしては動きますが、実務ではまずやりません。

理由はmainが「いつでも動く状態」であるべきだからです。作りかけのものを直接入れてしまうと、他の人がそれを取り込んだ瞬間に壊れます。だから作業ごとに別のブランチを切って、完成してから合流させます。

git branch feature/profileで枝を作り、git checkout feature/profileでそこへ移動します。作っただけでは移動しません——ここは最初によく間違えるところです。git checkout -b feature/profileと書けば作成と移動を一度にできます。

ブランチ名のfeature/は慣習です。feature/は新機能、fix/は不具合修正、というように頭に種類を付けておくと一覧が読みやすくなります。

git branchで確認すると、*が付いているのが今いるブランチです。

ブランチを移っても変更はついてきます。git statusを打つと、さっきと同じ3ファイルが変更済みのまま見えるはずです。

ここでgit add .を打ちます。.は「今のフォルダ以下すべて」の意味です。

Gitに独特なのがステージ(索引)という考え方です。他の多くのツールは「変更したもの＝記録するもの」ですが、Gitは間に一段はさみます。「変更したもの」の中から「今回コミットするもの」を選べるのです。

これのおかげで、5ファイル直したけれど関連する2つだけを先にコミットするといったことができます。コミットを意味のある単位に保てるので、後から履歴を読む人が助かります。

git addのあとgit statusを打つと、表示が「Changes to be committed(コミット予定)」に変わります。ここまで来て初めて、コミットの準備が整った状態です。

git commit -m "プロフィール欄を追加"で記録します。ここで初めて履歴に残ります。

-mはメッセージです。省略するとエディタが開くので、短いものは-mで付けるのが普通です。

メッセージの書き方は、後で効いてきます。「修正」「更新」とだけ書かれた履歴が並んでいても、半年後の自分には何も伝わりません。「何をしたか」が一目で分かる粒度——たとえば「プロフィール欄を追加」——にしておくと、git logがそのまま作業の記録になります。

git log --onelineで履歴を1行ずつ見られます。先頭に出ている7桁の英数字がコミットIDで、この変更のかたまりを指す名前です。あとで「この時点に戻したい」というとき、このIDを使います。

コミットIDは毎回変わります。このページに載っているIDと、あなたが打ったときのIDは一致しません。内容と時刻から作られるものなので、それで正常です。

作業が終わったのでmainに合流させます。ここで順番が大事です。

まずgit checkout mainで受け入れる側へ移動し、それからgit merge feature/profileを打ちます。マージは「今いるブランチに、指定したブランチを取り込む」動きをするので、移動を忘れると逆向きに取り込んでしまいます。ここはGitで最も間違えやすいところのひとつで、「どっちに取り込むんだっけ」と迷ったら「今いる場所が受け皿」と覚えてください。

マージが済んだらgit log --onelineを打ってみてください。さっきfeature/profileで作ったコミットが、mainの履歴にも現れています。これが合流できたということです。

実務ではこのあとgit pushでリモートに送り、GitHubなどでプルリクエストを出してレビューを受けます。そこまで含めて1本の流れです。

マージが済んだfeature/profileは、もう役目を終えています。残しておくとブランチ一覧が増えていくだけなので消します。

git branch -d feature/profileの-dは delete です。小文字の-dは「マージ済みなら消す」という安全な削除で、まだ合流していないブランチを消そうとするとGitが止めてくれます。大文字の-Dは強制削除で、これは確認なしに消えるので普段は使いません。

最後にgit statusとgit branchで締めます。「working tree clean(変更なし)」で、ブランチがmainだけ——これが1つの作業を終えたときのあるべき姿です。

これで完走です。ブランチを切る → コミット → マージ → 片付け。この4つが回せれば、チーム開発の入口は越えています。

ページ下の疑似ターミナルで、ここまでを最初から自分の手で通してみてください。読んで分かるのと打てるのは、別物です。

下は本物の疑似ターミナルです。まっさらな状態から始まるので、STEP1のコマンドから順に打って、マージまで辿り着いてください。読んで分かった気になるのと、自分で打てるのとは別物です。

詰まったら上のステップに戻って構いません。resetと打てば最初からやり直せます。