Git 与 GitHub —— 提交、推送、README：建立你的第一个仓库

本课导读

写文档你一定干过这种事：方案-最终版.docx、方案-最终版2.docx、方案-真最终版.docx……程序员的解法叫 Git：给项目拍"存档快照"，任何版本随时回去，文件名永远干净。再配上 GitHub（存放 Git 项目的云端社区），你的代码就有了备份、履历和展示柜——对转行者，GitHub 主页就是第二份简历。本课把这两样装好、跑通完整流程。预计 70 分钟。

心智模型：游戏存档 + 三个区

Git 的一切围绕"提交（commit）"——一次提交 = 一个存档点：记录当时所有文件的样子、时间、说明。存档多了连成时间线，可回看、可回退。

日常工作只在三个区之间搬东西：

工作区（你正在改的文件）
   │  git add  ——"这些改动我要存"
   ▼
暂存区（打包台：待存档的清单）
   │  git commit ——"咔嚓，存档！"
   ▼
仓库（历史存档架，永久记录）

为什么中间多个"打包台"？——因为一次存档未必想包含所有改动：改了 5 个文件，3 个是完成的功能、2 个是半成品，add 让你挑着存。先记住流程口诀：改 → add → commit，循环往复。

第一部分：本地 Git

分步操作

1. 安装 Git

   访问 git-scm.com 下载安装（Windows 一路默认即可；Mac 终端输 git --version，未安装会自动弹出安装引导）。装完在终端验证：git --version 出版本号即成功。

   截图占位：git --version 的输出
2. 自报家门（一次性配置）

   每个存档都要署名。在终端执行两行（引号里换成你的名字和邮箱，邮箱建议用你打算注册 GitHub 的那个）： git config --global user.name "你的名字" git config --global user.email "you@example.com"

3. 把项目变成仓库

   cd 进入 learnpath 下的 cli-practice 文件夹（上节课建的），执行 git init——这个文件夹从此被 Git 看管。git status 看一眼：它会列出“未跟踪”的文件（红色），意思是“这些我还没管，要管吗？”

   截图占位：git init 与 git status 的输出
4. 第一次存档

   git add . （那个点 = 当前文件夹的全部改动，全上打包台） git commit -m "第一次提交：倒计时练习" -m 后面是存档说明。再 git status——“工作区干净”，说明所有改动已入库。

   截图占位：第一次 commit 的输出
5. 改动 → 再存档（体验循环）

   在 VS Code 里给 countdown.py 加一行代码，存盘。终端 git status（红色：有新改动）→ git add . → git commit -m "倒计时加结束语" → git log --oneline 看时间线：两个存档点排排站，每个前面的乱码串是它的“身份证号”。

   截图占位：git log --oneline 显示两条提交记录

第二部分：推上 GitHub

本地仓库有了时光机，GitHub 再给它三样：云备份（电脑坏了代码还在）、展示柜（链接一发别人就能看）、协作场（将来贡献开源、团队开发都在这）。

分步操作

1. 注册 GitHub 账号

   访问 github.com 注册。用户名慎重取——它会出现在你所有作品的网址里（github.com/你的用户名），建议用简洁的英文名，这是你的技术门牌号。

   截图占位：GitHub 注册页
2. 在 GitHub 上建一个空仓库

   登录后点右上角 + 号 → New repository。仓库名填 cli-practice，其他全部保持默认（不要勾选任何初始化选项，我们要推本地已有的仓库），点 Create repository。

   截图占位：新建仓库页面，红圈标出不勾选初始化选项
3. 把本地仓库和云端接线

   建好后 GitHub 会显示一页命令，找到 "…or push an existing repository" 那一段，把那两三行复制到你的终端执行（形如 git remote add origin https://github.com/你/cli-practice.git 加 git push -u origin main）。首次 push 会弹出浏览器登录授权——点确认即可，之后不再重复问。

   截图占位：首次 push 时的浏览器授权弹窗
4. 见证时刻

   刷新 GitHub 仓库页面：你的代码上线了。点开 countdown.py 能直接看内容，点 commits 能看到你的两条存档记录。以后每次本地 commit 完，一句 git push 就同步上云。

   截图占位：GitHub 仓库页面显示已上传的代码

README：仓库的门面

打开任何一个受欢迎的 GitHub 项目，首页那篇说明文档就是 README.md（md = Markdown，你写笔记用的格式！）。它回答访客三个问题——这是什么、为什么有用、怎么用。给仓库补一个：

# cli-practice

我的命令行与 Git 练习仓库（LearnPath 学习项目）。

## 内容
- countdown.py —— for 循环倒计时练习

## 运行
python countdown.py

保存后走一遍循环：git add . → git commit -m "添加 README" → git push。刷新仓库页——GitHub 自动把它渲染成了首页门面。从今天起的规矩：每个公开仓库必须有 README，哪怕三行——没有说明的代码，别人（包括未来的你）根本不会点开第二眼。

随堂测验

随堂测验0 / 5 题正确

1. 一次 commit（提交）本质上是？

A把代码发布给用户B一个存档点：记录当时全部文件的快照 + 时间 + 说明，随时可回看C删除旧版本D上传到 GitHub

2. git add 和 git commit 的分工是？

Aadd 上传，commit 下载Badd 把改动放上“打包台”（挑着存），commit 正式咔嚓存档C两个是同义词Dadd 删除文件，commit 恢复文件

3. git push 做的事是？

A把云端代码拉到本地B把本地仓库的新提交同步到 GitHub——本地时光机 + 云备份/展示从此打通C删除本地仓库D自动写 README

4. README.md 的核心使命是回答？

A代码有多少行B这是什么、为什么有用、怎么用——仓库的门面与说明书C作者的年龄D运行速度

5. 对转行者来说，GitHub 主页的意义是？

A只是代码网盘B第二份简历——作品、提交记录、活跃度都是可被查证的能力证明C社交软件D必须付费才有价值

本课小结

• Git = 项目时光机：改 → add（打包台）→ commit（存档） 循环；git log --oneline 看时间线
• commit 说明一句话说清改了什么——写给三个月后的自己
• GitHub = 云备份 + 展示柜 + 第二简历：本地 commit 后 git push 同步上云
• README.md 是门面（是什么/为什么/怎么用），公开仓库必备；.gitignore 下课登场

零件全齐了。下一课单元验收：把 U1.3 的批量整理器搬到本地跑通、配上 README、推上 GitHub——你的第一件公开作品，上架。