GIT · 入門
Git入門:作業ツリー・ステージ・コミット・ブランチの違い
Gitは、ファイルの変更を履歴として記録するバージョン管理システムです。ファイルの保存、次の記録に含める内容の選択、コミット、共有先への転送を分けて考えます。SQLファイルへ条件を足す例で、どの内容が記録されるかを追いましょう。
保存したファイルと次のコミットの内容を区別し、ブランチとリモートの役割を説明できる。
ファイルとフォルダーが分かれば始められます。GitHubのアカウントやAWS、実DBへの接続は不要です。表示する状態は学習用の想定です。
保存・選択・記録・共有を分ける
手元で編集するファイル群。保存しても、まだ新しい履歴ではない。
次のコミットへ含める内容を選ぶ。git addで更新する。
選んだ内容を履歴へ記録する。後の編集とは区別できる。
別のリポジトリへ履歴を送る。GitHub以外でもよい。
左から内容を選び、記録し、必要なら共有する段階です。リモートは必須ではなく、レビューや本番配信も別の工程です。
リポジトリは、プロジェクトの履歴を管理する場所です。Gitは手元のリポジトリだけで使えます。GitHubは履歴の共有や共同作業を支援するサービスで、Gitを動かすための必須条件ではありません。まず手元の内容が何かを確認します。
ステージは「今のファイル」へ自動追従しない
学習用のsql/monthly_report.sqlで、承認済みレポートを選ぶ条件へregion = JPを足します。ここでgit addを使って選んだと仮定します。その後に月の条件も書き足して保存したら、作業ツリーは「JP+月」、ステージは「JPだけ」になり得ます。
| 段階 | 作業ツリー | ステージ | 最新コミット |
|---|---|---|---|
| 編集前 | 承認済みの条件 | 承認済みの条件 | B:承認済みの条件 |
| JPを選択後 | 承認済み+JP | 承認済み+JP | B:変更なし |
| 月も編集後 | 承認済み+JP+月 | 承認済み+JP | B:変更なし |
| 通常のコミット後 | 承認済み+JP+月 | 承認済み+JP | H:承認済み+JP |
通常のgit commitはステージの内容を記録します。この例では月の追加は未ステージなので、Hには入りません。保存できたことと、コミットへ入ったことを分けるのが要点です。意図した差分を確かめて選び直すか、未完成の編集として残すかを判断します。
どの内容を比較するかで、diffを使い分ける
| コマンド | 確認する対象 |
|---|---|
| git status | 作業ツリーとステージの変更状態 |
| git diff | 作業ツリーとステージの違い |
| git diff --staged | ステージと現在のコミットの違い |
| git log | コミットの履歴 |
| git branch | ローカルのブランチ |
| git remote -v | 設定されたリモートの名前と宛先 |
diffは、二つの内容の違いを読むための比較結果です。表示しただけでファイルを書き換えたり、変更を承認したりはしません。月の未ステージ編集を見たいならgit diff、次のコミットにJPが含まれるか見たいならgit diff --stagedというように、比較の両端を意識します。
コミットを作っても、他のブランチは進まない
コミットは内容と履歴上のつながりを記録し、ブランチはコミットを指す名前です。feature/jp-report-filterでHを作っても、mainは以前のBのままでかまいません。別のブランチへ変更を取り込む操作は、コミットを作る操作とは別です。BとHは説明用の名前で、実際のハッシュではありません。
リモートへ送る前に、宛先と内容を確認する
リモートは、別のGitリポジトリの宛先を名前で扱う設定です。originという名前をよく使いますが、必ずGitHubを指すという意味ではありません。pushは許可された宛先の参照を更新する操作で、未コミットの編集ファイルをそのまま送る操作でもありません。
- 送り先は意図したリポジトリか、共有される範囲は適切かを確認する。
- 鍵・パスワード・顧客データ等を履歴へ入れない。削除のコミットだけで既存の履歴まで消えたとは考えない。
- 転送成功と、PRレビュー・マージ・ビルド・配信の成功を分けて確認する。
状態の違いを確かめる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 保存した内容と、ステージへ選んだ内容を説明する。
- mainとfeatureが別のコミットを指せる理由を説明する。
- リモートへ送る前に、共有先と秘密情報を確認する。
理解を確かめる: ステージ後に編集した月の条件は、通常のコミットHへ自動で入る?
入りません。この例のHは、ステージへ選んだJP条件までです。
コミットの入力はステージなので、後からの作業ツリーの編集とは区別します。
出典と確認した条件
説明に用いた一次資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実環境での検証は行っていません。
確認した内容・条件作業ツリー・ステージ・コミットと、ステージ後の編集の区別。 公式資料の確認であり、実環境の検証ではありません。
参照した本文保存・選択・記録・共有を分ける ステージは「今のファイル」へ自動追従しない どの内容を比較するかで、diffを使い分ける 状態の違いを確かめる
確認した内容・条件リモートとpush。転送先や書込み権限は別の条件。 公式資料の確認であり、実環境の検証ではありません。
参照した本文保存・選択・記録・共有を分ける どの内容を比較するかで、diffを使い分ける リモートへ送る前に、宛先と内容を確認する 状態の違いを確かめる
確認した内容・条件ブランチがコミットを指す参照であること。 公式資料の確認であり、実環境の検証ではありません。
参照した本文どの内容を比較するかで、diffを使い分ける コミットを作っても、他のブランチは進まない 状態の違いを確かめる