メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

なぜ記録を残すのか

昨日まで動いていた作品が、今日の直しで動かなくなる。そんなときに昨日の形へ戻れるように、作品の変更を記録しておく仕組みがあります。これをバージョン管理と呼びます。

「売れ残り帳」の最初の形ができてから、3日がたちました。佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、夜ごとに少しずつ直してもらっています。字の大きさ、雨の印、表の並び。直すたびに、前の形は上書きされて、消えていきます。

問い

佐藤さんの疑問

直す前の形に戻りたくなったら、どうすればいいんだろう。

ひもで束ねた、厚い帳面4冊の挿絵。

第4部で、佐藤さんは、「売れ残り帳」の最初の形を、手元で作りました。

第5部では、作ったものを失わずに残し、人に見せられる場所に置くまでを見ていきます。この回では、まず、なぜ記録を残すのかを考えます。

昨日の形に、戻れない

ある晩、佐藤さんは、Claude に画面の並び方を変えてもらいました。すると、昨日まで正しく出ていた、あすの目安の数が、おかしくなりました。

「昨日の形に戻して」と頼みたくても、昨日の形が、どこにも残っていません。Claude は昨日の会話を覚えていないこともあります。書き換えたファイルは、上書きされています。

ノートに鉛筆で書いた、直したことの記録。2日目、字を大きく。3日目、雨の印をつける。3日目夜、並びを変えた。その下に、→目安がおかしい!と下線付きで書かれ、さらに小さく、前の形が、どこにもない、とある。
佐藤さんのノート(説明のために作った絵です)。直したことを、手で書き留めてはいました。それでも、前の形には戻れません。

この出来事は、説明のための架空の例です。

Word で文書を作るとき、「売れ残り帳_最終.docx」「売れ残り帳_最終2.docx」「売れ残り帳_本当に最終.docx」と、名前を変えて保存したことはないでしょうか。どれが新しいか分からなくなり、どこを変えたかも思い出せない。作品のファイルでも、同じことが起きます。

バージョン管理:変更の記録を残す仕組み

バージョンは、版のことです。初版、第2版の「版」です。作品のファイルに加えた変更を、版ごとに記録しておき、あとで前の版を呼び出せるようにする仕組みを、バージョン管理と呼びます。

バージョン管理の道具 Git(ギット)の公式の解説書『Pro Git』には、こう書かれています。

DOCUMENTATION

“Version control is a system that records changes to a file or set of files over time so that you can recall specific versions later.”

バージョン管理は、1つのファイルや、ファイルのまとまりに、時間とともに加えられていく変更を記録し、あとで特定の版を呼び出せるようにする仕組みです。

Scott Chacon, Ben StraubPro Git 著者Pro Git: About Version Control

序章の第1回で、リポジトリを「Word の変更履歴を、作品のファイル全部に付けたようなもの」と説明しました。その変更履歴を作るのが、バージョン管理です。

記録があると、何ができるか

  • 戻れる:うまくいかなかったら、動いていた版に戻せる
  • 比べられる:昨日と今日で、どこが変わったかが分かる。第4部の第8回で見た差分(変える前と変えたあとの違い)を、版と版のあいだでも見られる
  • 安心して試せる:戻れると分かっていれば、思い切った直しも頼める

ハッカソンにも、つながります。第2部の第3回で見たとおり、提出物に、作品の中身を公開リポジトリで出すように求める大会があります。記録を残しておけば、それがそのまま提出物の土台になります。

バージョン管理は、作品の変更を版ごとに記録し、あとで前の版に戻れるようにする仕組みです。

注意

ただし、記録は自動では残らない

バージョン管理の道具は、何もしなくても全部を覚えてくれるわけではありません。「ここで記録して」と決めたときに、その時点の形が残ります。

いつ、どう記録するかは、このあとの回で見ていきます。まずは、「動いたら記録する」と覚えておいてください。

次回の問い

佐藤さんの次の疑問です。作品の記録を残す道具は、何を使い、どう始めればよいのでしょうか。

参考

Pro Git:バージョン管理に関して
バージョン管理とは何かを説明した、Git の公式の解説書の章。日本語。
git-scm.com · git-scm.com
Vibe Coding 用語集:バージョン管理
バージョン管理の説明と、出てくる場面。
AMPL · Web

このレッスンは役に立ちましたか?