第 6 章:实操:和 AI 编程工具一起用
本章目标:把前五章串成一套从建项目到推送的完整流程;养成和 AI 编程工具配合时的三个 Git 习惯;最后附一张命令速查。
开篇:零件都齐了
前五章各讲了一样:终端、路径、环境变量、Git、GitHub。单独看都不难,真正用起来是连在一起的:新建一个项目,十分钟之内这几样全会用到。
这一章先把它们串一遍,再讲一件现在最常遇到的事:让 AI 编程工具改你的代码时,Git 怎么帮你兜底。
学完这一章,你能:
- 不看教程,从零建好一个带 Git 和
.gitignore的项目,并推到 GitHub - 让 AI 改代码前后,知道该敲哪几条命令
- 用速查表随时找到需要的命令
6.1 从零开始的完整流程
以周报生成器为例,从一个空文件夹到推上 GitHub:
# 1. 建文件夹,走进去(第 2 章)
mkdir -p ~/projects/weekly-report
cd ~/projects/weekly-report
# 2. Key 已经长期保存过就跳过(第 3 章)
echo $DEEPSEEK_API_KEY
# 3. 建仓库,先写 .gitignore(第 4、5 章)
git init
printf '.env\n__pycache__/\n.venv/\n' > .gitignore
# 4. 放进 weekly.py、notes.md,跑通
python3 weekly.py
# 5. 存档
git add .
git status # 确认列表里没有 .env
git commit -m "周报生成器第一版"
# 6. 推到 GitHub(先在网页上建好私有空仓库)
git remote add origin https://github.com/你的用户名/weekly-report.git
git push -u origin main# 1. 建文件夹,走进去(第 2 章)
mkdir ~\projects\weekly-report
cd ~\projects\weekly-report
# 2. Key 已经长期保存过就跳过(第 3 章)
echo $env:DEEPSEEK_API_KEY
# 3. 建仓库,先写 .gitignore(第 4、5 章)
git init
Set-Content .gitignore ".env`n__pycache__/`n.venv/"
# 4. 放进 weekly.py、notes.md,跑通
python weekly.py
# 5. 存档
git add .
git status # 确认列表里没有 .env
git commit -m "周报生成器第一版"
# 6. 推到 GitHub(先在网页上建好私有空仓库)
git remote add origin https://github.com/你的用户名/weekly-report.git
git push -u origin main第 5 步那句 git status 别省:git add . 会把所有没被忽略的文件都加进去,提交前扫一眼列表,是最后一次拦住 Key 的机会。
6.2 和 AI 编程工具一起用的三个习惯
AI 编程工具(Lv0「AI 工具上手」第 3 章)改代码又快又多。Git 让你敢放手让它改:
习惯一:改之前,工作区是干净的。
git status看到 nothing to commit, working tree clean 再让它动手。有没存档的改动,先 commit。这样它改完以后,git diff 里显示的全是它改的,不会和你自己的改动混在一起。
习惯二:改完,先看 diff 再说好。
git diff不管它的总结说得多好,自己看一遍 - 和 +。第 4 章那个例子里,它把 notes.md 改成了 note.md,总结里不会告诉你这件事。很多 AI 编程工具会直接把改动对比显示给你看,道理一样:看改动,不看汇报(《AI Agent 科普》第 4 章)。
习惯三:满意就存档,不满意就退回。
# 满意
git add .
git commit -m "让 AI 加了上周对比功能"
# 不满意,全部不要
git restore .git restore . 会把所有没存档的改动都丢掉,回到上一个档。注意它只管「原来就有的文件」:AI 新建的文件不会被删掉,git status 里会显示成 Untracked,确认不要以后手动删。如果它已经帮你 commit 了,就用 git revert。
一个档只放一件事。让 AI 连做三件事、最后一起存档,回头想撤掉其中一件就难了。
6.3 命令速查
| 想做什么 | macOS | Windows(PowerShell) | 出处 |
|---|---|---|---|
| 我在哪 | pwd | pwd | 第 1 章 |
| 这里有什么 | ls | ls | 第 1 章 |
| 进入 / 退回 / 回家 | cd 名字 / cd .. / cd ~ | 同左 | 第 2 章 |
| 新建文件夹 | mkdir 名字 | mkdir 名字 | 第 2 章 |
| 打开当前文件夹窗口 | open . | explorer . | 第 2 章 |
| 看环境变量 | echo $名字 | echo $env:名字 | 第 3 章 |
| 长期保存环境变量 | 追加到 ~/.zshrc | setx 名字 "值" | 第 3 章 |
| 这条命令是哪个程序 | which python3 | where.exe python | 第 3 章 |
| 建仓库 | git init | 同左 | 第 4 章 |
| 看状态 / 看历史 | git status / git log --oneline | 同左 | 第 4 章 |
| 存档 | git add 文件 → git commit -m "说明" | 同左 | 第 4 章 |
| 看改动 | git diff | 同左 | 第 4 章 |
| 丢掉没存档的改动 | git restore 文件(全部:git restore .) | 同左 | 第 4 章 |
| 撤销一次存档 | git revert 编号 | 同左 | 第 4 章 |
| 推到 GitHub | git push | 同左 | 第 5 章 |
想深入 Git 的分支、合并,可以接着看工具笔记《git merge、squash、rebase》。
试一试
- [ ] 不看前面的章节,照 6.1 从零建一个新项目(比如
hello-ai)并推到 GitHub - [ ] 下次用 AI 编程工具改代码,按 6.2 的三个习惯走一遍:先
status,改完diff,再决定 commit 还是 restore
本章小结
| 要点 | 说明 |
|---|---|
| 完整流程 | 建文件夹 → 确认 Key → git init + .gitignore → 跑通 → 存档 → 推送 |
| 提交前 | git status 扫一眼,别把 .env 带进去 |
| AI 改代码前 | 工作区干净 |
| AI 改代码后 | 先看 git diff,满意 commit,不满意 restore |
| 一个档一件事 | 想撤销时才撤得干净 |
课程结束
六章走完,「打开终端,运行……」这句话不会再让你停下来了;AI 把代码改坏了,你知道怎么一条命令退回去;Key 不会再出现在你的仓库里。
接下来可以去:
- Lv2 主线「大模型 API 调用」:周报生成器的完整版,本课用到的环境变量、路径都会派上用场
- Lv1「Python 零基础」:想把
weekly.py里每一行都看懂
👉 回到课程首页