初遇Git小精灵：魔法森林的奇妙约定 / Meet Git the Sprite: The Magical Forest Pact

橙色的凤尾蝶扇着翅膀，像一片会飞的小太阳，从你刚拆开包装的草莓味饼干旁边掠过，你举着半块饼干追上去，踩过软乎乎的苔藓，碰得路边的小蘑菇晃了晃白白的伞盖，风里飘着野草莓的甜香，还有远处松树针叶的清苦味。本来今天是和爸爸妈妈来魔法森林野餐的，爸爸在铺格子野餐垫，妈妈在拿火腿三明治，你追着蝴蝶跑得太急，拐过三棵一样的橡树之后，就发现周围的树都长得一模一样，铺满落叶的小路也不见了，爸爸妈妈的声音也听不到了。

天色慢慢暗下来，路边的小雏菊合上了花瓣，萤火虫提着小绿灯从树丛里飞出来，你坐在一个老树根上，抱着膝盖小声哭，眼泪把裤腿沾湿了一小块。这时候你听到“叮铃、叮铃”的轻响，像风铃被风吹动的声音，一团暖黄色的光从树丛后面飘过来，越来越近，你揉了揉眼睛，才发现是个会发光的小精灵！

小精灵的头发是嫩绿色的，像刚冒出来的柳芽，扎着两个小辫子，辫子上系着小小的银色铃铛，走起来就叮铃叮铃响。她的翅膀是半透明的，像沾了清晨露珠的枫叶，翅膀尖上闪着细细的金光，落下来的时候，几片小亮片飘在你手心上，凉丝丝的，像刚含过的薄荷糖。她怀里抱着一个木质的小本子，封面刻着小树叶的图案，本子周围飘着细碎的小星星，像把一小片星空揣在了怀里。

“哎呀呀，你怎么哭啦？是不是迷路啦？”小精灵的声音软乎乎的，像棉花糖，“我是Git小精灵，这片魔法森林的版本守护者哦！Version Control Sprite，你也可以叫我Git，发音和你中文里的‘给’差不多哦～”

你抽抽鼻子，擦掉眼泪问她：“版本守护者是什么呀？是帮森林里的动物找丢失的东西的吗？” Git小精灵笑着晃了晃手里的魔法笔记本，翅膀扇得更快了，周围的亮星闪得更欢：“对呀对呀，不过不是找丢的玩具和松果，是帮大家‘找丢的版本’哦！Version，就是版本，Control就是控制、保管的意思，合起来叫版本控制（Version Control），就是帮大家把所有改过的东西都好好记下来，改坏了也不怕，想回到哪一次改的样子都行！”

“改过的东西？”你有点懵，“就像我昨天画的画吗？我昨天画了一只小猫，今天改了改，把它的尾巴改短了，原来的尾巴就没了。” “对啦对啦！就是这个！”Git小精灵开心地蹦了一下，辫子上的铃铛叮铃响，“你有没有过改坏了东西，找不到原来的样子的时候呀？比如你搭乐高搭到一半，想试试另一种搭法，结果把原来的弄坏了，拼不回去了？或者你写故事，写了一半觉得写得不好，全删了，后来又想不起来之前写的是什么了？”

你赶紧点头，上周你搭的恐龙乐高，就是想试试加个翅膀，结果拆了之后拼不回去，你哭了半小时呢。 Git小精灵指了指怀里的魔法笔记本：“别担心呀，以后有我在，就不会有这种烦恼啦！这个就是我的魔法笔记本（Magic Notebook），你也可以叫它Git仓库（Git Repository），是专门用来存所有‘版本快照（Version Snapshot）’的哦！”

“版本快照是什么呀？”你凑过去看，魔法笔记本的页面上飘着三个亮晶晶的小图片：第一个是整整齐齐的天蓝色小木屋，第二个是粉粉的像草莓冰淇淋的小木屋，第三个是刚刷了米黄色边的小木屋。 Git小精灵给你解释：“你看呀，之前森林里的小明、小红、小刚三个小朋友，一起在树上搭了个小木屋，他们想给木屋刷漆，第一次刷了天蓝色的，觉得不好看，改成粉色的，又觉得粉色太艳，改成米黄色的，结果改到一半，不小心把一整桶天蓝色的漆洒在了木屋上，木屋一半是没盖住的粉色，一半是洒了的蓝色，乱得像调色盘，三个小朋友都哭了，说找不到之前的样子了。”

你跟着皱起眉头：“那怎么办呀？他们之前的木屋就没了？” “才不会呢！”Git小精灵挥了挥手，魔法笔记本上的三个小图片飘得更高了，“你看，每次他们改完木屋，我都会偷偷‘咔嚓’一声，把整个木屋的样子拍一张照片，存在我的魔法笔记本里，这个就是版本快照哦！不是只记他们改了什么，是整个木屋的所有细节都记下来：蓝色的漆刷了哪些地方，小刚在木屋角上画的小鸭子，还有木屋上的小裂纹，都清清楚楚地存着呢！”

她点了点最上面那张天蓝色木屋的图片：“你看，这是他们第一次刷完漆的版本，我给它起名叫‘v1：天蓝色木屋’，v就是version的缩写，就是第1版的意思；这张是刷完粉色的，叫‘v2：粉色冰淇淋木屋’；这张是刷了米黄色边的，叫‘v3：米黄色木屋’，就算现在木屋被洒了漆，我也能翻到之前的任何一页，把木屋变回那个样子，所有的细节都在，不会丢任何东西！”

你眼睛亮了起来：“那是不是不管改多少次，你都能记下来呀？” “当然啦！”Git小精灵骄傲地挺了挺胸，“而且这个魔法笔记本是永远不会坏的，就算你把木屋全拆了，或者把所有的漆都泼上去，我这里的快照都好好的，永远都不会丢。你改多少次都没关系，改坏了就翻到之前的版本，重新来就好，完全不用怕！”

她给你看了魔法笔记本里更多的页面，有小松鼠埋松果的版本：v1是埋在橡树底下，v2是埋在松树底下，v3是埋在花丛底下，每一页都标得清清楚楚，冬天找松果的时候，小松鼠再也不用挖遍整个森林了；还有小兔子做窝的版本：v1是用干草搭的，v2是加了梧桐树叶的，v3是加了蒲公英绒毛的，上次小兔子搭到一半被风吹散了，翻到v2的版本，很快就做好了新的窝，一点都没哭。 “你是不是以为Git只能用来记木屋、记松果呀？”Git小精灵笑着眨了眨眼，“才不是呢！不管你画画、做手工、写作业、搭乐高，甚至编故事，都可以用它来记哦！比如你画了一幅画，改了三次，第一次画太阳是圆的，第二次改成方的，第三次又改回圆的，要是没记的话，你忘了方的太阳是怎么画的了，用Git的话，每一步都给你存得好好的，你想看哪次看哪次～”

她翻到魔法笔记本里的一页，上面画着三只小猫：第一只的尾巴是圆的，第二只的尾巴是方的，第三只的尾巴是尖的，旁边写着“v1：圆尾巴小猫”“v2：方尾巴小猫”“v3：尖尾巴小猫”，是之前森林里的小猫画的自画像，改了好几次，用Git存了下来。 “你看，就连小猫画画都能用，你是不是也能用呀？”Git小精灵把魔法笔记本往你怀里送了送，“不过现在这个是我的魔法笔记本，不能给你哦，下次我带你去森林里的小木屋，那里有专门给小朋友准备的Git魔法笔记本，我教你第一次怎么把你的作品存进去，好不好？”

你赶紧点头，刚想问小木屋在哪里，就听到远处传来爸爸妈妈喊你的声音，他们找过来了！你高兴地站起来，挥着手喊“我在这里！”，再转头看Git小精灵，她已经飞到了树丛上面，翅膀上的亮光闪呀闪，像一颗小小的星星。 “记住哦！”她的声音从风里飘过来，“以后改东西的时候，别忘了叫上Git小精灵呀！下次见咯～”说完就飞走了，只有叮铃叮铃的铃声，还有落在你手心的亮片，证明刚才不是梦。

爸爸妈妈跑过来，把你抱在怀里，问你刚才跟谁说话呢，你举着手心里还发着光的亮片，笑着说：“我跟Git小精灵玩了，它有个魔法笔记本，能记下所有改过的东西，再也不怕改坏了！” 爸爸笑着摸了摸你的头：“Git呀，我知道，是那个帮大家记工作的小工具，是不是？改天爸爸教你用，好不好？” 你开心地点头，心里想着Git的魔法笔记本，已经迫不及待想快点到下次，去小木屋里学怎么用这个神奇的魔法了。

--- 💡 小知识（纸书侧边栏 / 电子版可点击展开 / Markdown标签：`<sidebar id="git-intro">`） 你知道吗？Git原本是程序员用来管理代码的工具，是Linux之父林纳斯·托瓦兹在2005年开发的，现在全世界有超过1亿程序员用它来写代码。不过Git才不是只有程序员才能用呢！就像Git小精灵说的，不管你画画、做手工、搭乐高、写故事，只要怕改坏了找不回原来的样子，都可以用它来记录哦！

--- 🔍 双语小课堂（中英对照） | 中文 | English | 解释 | |------|---------|------| | 版本控制 | Version Control | 记录所有修改，能随时回到任意历史版本的方法 | | Git | Git | 既是魔法小精灵的名字，也是魔法笔记本的名字哦 | | 魔法笔记本 / Git仓库 | Magic Notebook / Git Repository | 存所有版本快照的地方，就像你的专属魔法收纳盒 | | 版本快照 | Version Snapshot | 每次修改完成后，Git拍的“完整照片”，记下当时的所有细节 | | 提交 | Commit | 把当前的版本快照存进Git仓库的动作，就像把你的作业交给老师保管 | | 提交历史 | Commit History | Git仓库里所有存下来的版本快照，按时间顺序排好队，随时可以翻 |

--- ✏️ 小练习（纸书可填写 / 电子版可交互提交 / Markdown标签：`<exercise id="1-1">`） 拿出你的画画本或者一张白纸，完成下面的任务： 1. 先画一朵你喜欢的小花，给这个版本起名叫「v1：初版小花」 2. 改一改你的小花：比如把花瓣数量从5片改成6片，颜色从红色改成粉色，给这个版本起名叫「v2：改版小花」 3. 再改一次：比如给小花加上叶子，把花茎改成弯的，给这个版本起名叫「v3：最终版小花」 4. 现在你就是自己的Git小精灵啦！这三个版本就是你的“版本快照”，以后你想看哪次画的小花，随时都能找到哦～

--- 💭 想一想（纸书思考框 / 电子版可查看其他小朋友的回答 / Markdown标签：`<interactive-question id="1-1">`） 你有没有过改坏了东西，找不回原来的样子的经历？那时候你是什么感觉呀？如果有个Git魔法笔记本，你觉得能帮你解决什么问题？

--- 📖 纸书排版说明 本章在纸书中的排版为：章节标题「第1章 初遇Git小精灵：魔法森林的奇妙约定」居中加粗，每页底部有页码，插画位置标注在“小精灵抱着魔法笔记本飘在树丛里”的段落旁边，小知识框放在页面右侧，小练习放在页面底部。

--- 📱 电子版交互说明 1. 点击Git小精灵的魔法笔记本图标，可以查看树屋刷漆的三个版本快照的动态展示 2. 点击“想一想”的蓝色按钮，可以查看其他小朋友的回答，也可以提交自己的回答 3. 小练习完成后点击提交，会得到一个“Git小精灵认证的小版本记录员”的电子小贴纸

--- ```mermaid graph TD A[你完成作品修改] --> B[Git自动拍一张完整的版本快照] B --> C[把快照存在魔法笔记本里，按顺序排好] C --> D[你可以随时翻到任何一页，回到对应的版本] style A fill:#f9f,stroke:#333,stroke-width:2px style B fill:#9f9,stroke:#333,stroke-width:2px style C fill:#99f,stroke:#333,stroke-width:2px style D fill:#ff9,stroke:#333,stroke-width:2px ``` *（本图表展示Git版本控制的核心流程，点击可以放大查看哦～）*

--- 🤖 Markdown结构化标签（供AI/程序处理） ```markdown <chapter id="1" title="初遇Git小精灵：魔法森林的奇妙约定" title-en="Meet Git the Sprite: The Magical Forest Pact"> <section id="1-1" type="scene-setting"> <content>迷路森林的场景描写</content> <bilingual-term id="term-forest">森林 / Forest</bilingual-term> </section> <section id="1-2" type="character-intro"> <content>Git小精灵的外貌、名字、身份介绍</content> <bilingual-term id="term-git">Git小精灵 / Git the Sprite</bilingual-term> <bilingual-term id="term-version-control">版本控制 / Version Control</bilingual-term> </section> <section id="1-3" type="concept-explanation"> <content>魔法笔记本、版本快照、提交的概念解释</content> <bilingual-term id="term-repo">Git仓库 / Git Repository</bilingual-term> <bilingual-term id="term-snapshot">版本快照 / Version Snapshot</bilingual-term> <bilingual-term id="term-commit">提交 / Commit</bilingual-term> </section> <section id="1-4" type="example"> <content>树屋刷漆的案例讲解</content> <example-id>treehouse-paint</example-id> </section> <section id="1-5" type="interaction"> <content>互动问题、小练习、小知识</content> <interactive-id>question-1-1</interactive-id> <exercise-id>exercise-1-1</exercise-id> <sidebar-id>git-intro</sidebar-id> </section> <section id="1-6" type="

你举着还发着光的小亮片，刚想问问Git小精灵的小木屋在哪里，就听见爸爸笑着拍了拍你的头：“刚才你说的Git小精灵，是不是头上扎绿辫子、翅膀像枫叶的那个？我知道她说的木屋在哪里，就在前面最高的那棵千年橡树顶上，咱们走过去看看吧？” 妈妈笑着把野餐垫收起来，递给你一杯温热的苹果汁：“森林里的小朋友都喜欢去那个小木屋玩，里面有好多用Git记下来的作品，改多少次都不会丢，上次小象搭的黏土城堡被雨淋坏了，就是用Git的版本恢复的，一点都没重新做。” 你抱着苹果汁，跟着爸妈往橡树的方向走，路边的小松鼠抱着松果从树上探出头，朝你挥挥爪子，你才发现它尾巴上系着个小标签，上面写着“v3：松果藏在第三棵橡树底下”，是Git小精灵给它记的松果位置呢！小松鼠指了指橡树的方向，就蹦蹦跳跳跑远了，好像在给你们带路。 越往橡树走，周围的树就越密，路边的野草莓越来越多，红得像小灯笼，你摘了一颗塞进嘴里，甜汁在嘴里爆开，比超市买的甜多了。走了大概十分钟，你就看见那棵千年橡树了，树干比三个爸爸加起来还粗，树冠遮得连太阳光都透不进来，只有细碎的光斑落在爬满牵牛花的藤蔓梯子上，梯子旁边挂着一个木制的小牌子，上面歪歪扭扭写着“Git小木屋：改错了也不怕”，牌子旁边还画了个扎绿辫子的小精灵，正是Git小精灵的样子。

【插画2：千年橡树上的Git小木屋，藤蔓梯子旁边挂着木牌，小精灵的卡通画像贴在牌子上，小松鼠抱着松果从树上探出头】 你拉着爸妈的手，踩着软乎乎的藤蔓梯往上爬，梯子上的牵牛花花瓣蹭得你手心痒丝丝的，爬到一半的时候，你看见Git小精灵正坐在木屋的窗台上晃腿，看见你上来，她挥着手里的魔法笔记本，翅膀扇得哗啦啦响，铃铛声叮铃叮铃的，比刚才在树丛里听见的还清楚。 “我就知道你会来呀！”她跳下窗台，拉着你的手往木屋里走，“这个木屋是森林里的小朋友一起建的，专门用来学Git的魔法哦！” 木屋里面的空间比外面看起来大得多，像被施了放大魔法，墙角堆着乐高积木、画画本、黏土和彩纸，墙上贴满了花花绿绿的纸，每张纸都画着同一个东西的不同版本：第一张是歪歪扭扭的小猫简笔画，旁边写着“v1：草稿小猫”；第二张是加了胡须和爪子的小猫，写着“v2：加了细节的小猫”；第三张是涂了黄色花纹的小猫，写着“v3：最终版小猫”，每张纸的角落都贴了个小小的Git小精灵贴纸。 桌子中间摆着好多硬壳的小本子，封面上都印着小树叶的图案，和Git小精灵抱的魔法笔记本一模一样。Git小精灵拿起一个本子，翻到你之前看到的树屋刷漆的那一页，三个版本的树屋快照还在上面飘着：“这些就是小朋友们自己的魔法笔记本啦，每个人都可以有一个，用来记自己的作品，以后不管改多少次，都不会丢原来的样子。” 这时候门被推开，一只戴眼镜的小熊抱着积木筐走了进来，看见你们，有点不好意思地挠挠头：“Git小精灵，我刚才搭的积木城堡被我不小心碰倒了，你能帮我变回刚才的样子吗？” Git小精灵笑着点头，拿过小熊的魔法笔记本，点了点最新的一页，页面上飘着一个很漂亮的积木城堡：有尖尖的塔楼，还有小小的护城河，旁边写着“v3：加了护城河的城堡”。她点了一下“恢复”按钮，就见那些亮晶晶的积木从笔记本里飞出来，叮叮当当的，不到一分钟就拼成了和之前一模一样的城堡，连塔楼顶上那个歪了的小旗子都在原来的位置。 “哇！”你忍不住拍手，“太厉害啦！” Git小精灵把笔记本还给小熊，给你解释：“你看呀，小熊刚才搭城堡，第一次搭了基础的样子，我给它存成了v1版本；第二次加了塔楼，存成v2；第三次加了护城河，存成v3。刚才碰倒了没关系，我只要把v3的快照调出来，所有的积木块都在原来的位置，连他刚才不小心多放了一块红色积木在塔楼底下的事都记得清清楚楚，所以拼起来和之前一模一样呀。” 你凑过去看小熊的笔记本，发现每一页的快照旁边都有一行小字，是小熊自己写的：“v1：基础城堡，用了32块积木”“v2：加了两个塔楼，多了12块积木”“v3：加了护城河，多了8块积木”，你好奇地问Git小精灵：“这些小字是什么呀？” “这个是提交说明（Commit Message）哦！”Git小精灵点了点那行字，“就是你存版本快照的时候，写的一句话，告诉大家这个版本改了什么东西，这样以后你翻的时候，不用一个个看快照，看说明就知道哪个版本是你想要的啦！比如你找加了护城河的版本，直接看说明里有‘护城河’的就行，不用挨个翻。” 她翻到笔记本的前几页，给你看没有写提交说明的版本，旁边只有“v1”“v2”的字样，她吐了吐舌头：“这个是小熊第一次用Git的时候存哒，当时他还不知道要写说明，后来就每次都写啦，不然以后翻的时候会找不到想要的版本的～” 你赶紧点头，觉得自己已经记住了：存版本的时候一定要写说明，就像给作业标好日期和题目一样，以后找的时候方便。 Git小精灵又给你看了小熊的提交历史（Commit History）：所有存过的版本快照都按时间顺序排好队，最上面是最新的v3，下面是v2、v1，每个版本旁边都有存的时间：“2024年5月21日 下午3点”“2024年5月21日 下午2点45分”“2024年5月21日 下午2点30分”，像一本完整的作品成长日记。 “你有没有发现呀？”Git小精灵点了点v1的版本快照，