适用人群:第一次听说 Git、刚学编程、只会 Ctrl+C/V 的小白 教程目标:15 分钟完成“一次增删改查 → 第一次提交 → 第一次推送”完整闭环 只需安装:① Git(官方下载)② VS Code(非必须,但可少打字)
词 | 通俗说法 | 类比 |
|---|---|---|
仓库 repository | 项目的“文件夹” | 作业本 |
分支 branch | 同一本书的不同草稿 | 主分支=成稿,副分支=草稿 |
暂存区 stage | 购物车 | 先把想买的东西放进去 |
提交 commit | 购物车里的一件商品结完账 | 给草稿拍照 |
推送 push | 把本地作业上传到云端 | 交作业给老师 |
拉取 pull | 把云端最新作业抄回来 | 抄同桌的答案 |
git --version # 验证安装是否成功
git config --global user.name "你的昵称"
git config --global user.email "你的邮箱@xx.com"
# 让 VS Code 当默认编辑器(可省,敲空格继续)
git config --global core.editor "code --wait"
mkdir hello-git # 1. 建文件夹
cd hello-git # 2. 进文件夹
git init # 3. 变身 Git 仓库 → .git 隐藏文件夹出现
echo "# 我的第一个仓库" > README.md
git clone https://github.com/你的用户名/远程仓库.git
cd 远程仓库
📌 Tips:只要本地有
.git文件夹就是仓库,别怕路径不同。
在 README.md 中加一行:
## 小白第一天学 Git,紧张又开心
顺手再新建文件:
touch hello.py
echo 'print("Hello from Python")' > hello.py
git status # 看哪些文件是红色(未跟踪 / 已修改)
git add README.md # 只把 README.md 搬进购物车
git add . # 懒人写法:全部文件一起搬
git status # 再敲一次,绿色就说明成功
git commit -m "feat: 添加 README 与 hello.py 第一次文件"
✨ 小贴士:前缀惯例 feat: 新功能 fix: 修 bug docs: 文档 style: 样式
# 先去 GitHub/Gitee 网页新建一个空仓库,拿到 HTTPS 链接
git remote add origin https://github.com/你的用户名/hello-git.git
git branch -M main
git push -u origin main
弹窗输入 GitHub 账户+密码 / Token(勾选“记住”可免下次)。
场景 | 命令速查 |
|---|---|
开工前同步小伙伴最新代码 | git pull |
写完功能 | git add . → git commit -m "描述" |
下班前交作业 | git push |
症状 | 急救 |
|---|---|
git status 全是红色 | add . 把文件放进去 |
忘记写 .gitignore 把垃圾文件也提交了 | ① echo "*.log" > .gitignore ② git rm -r --cached 垃圾文件或文件夹 ③ 重新 add & commit |
提交信息写错 | git commit --amend -m "新信息"(没 push 前可改) |
误删文件 | git checkout -- 文件名 秒恢复 |
push 失败说“远程有更新” | git pull --rebase → 无冲突后再次 push |

git log --oneline --graph --all # 树状历史
git shortlog -sn # 谁最勤奋
恭喜你!你已经完成首次 Git 旅行。保持每天
add/commit/push,一周就变成肌肉记忆。下次再遇到“代码不见了”——记得还有 git reflog 这个时光机。
参考与扩展阅读
https://code.visualstudio.com/docs/sourcecontrol/overview
https://www.runoob.com/manual/git-guide/