第 5 章:.gitignore 和 GitHub
本章目标:用
.gitignore让 Key 和缓存文件永远不进仓库;知道 Key 已经提交过以后为什么「删掉文件」不管用、该怎么补救;把仓库推到 GitHub。
开篇:最常见的泄露
一个很常见的事故:为了方便,把 Key 写进了项目里的 .env 或 config.py。某天顺手 git add .,存档、推到 GitHub。几个小时后,账户余额被刷光了。
公开仓库里的 Key,会被专门扫描的程序很快捡走。《大模型 API 调用》第 1 章说过「Key 不进代码、不进 Git」,这一章讲怎么用工具保证这件事。
学完这一章,你能:
- 写一个
.gitignore,让 Git 对某些文件视而不见 - 明白「后来删掉」为什么不管用,Key 泄露了该做什么
- 在 GitHub 上建仓库、把本地仓库推上去
5.1 .gitignore:告诉 Git 别管这些
假设项目里有了这两样东西:
.env:里面写着DEEPSEEK_API_KEY=sk-...,脚本从这里读 Key__pycache__/:Python 运行时自动生成的缓存,没必要存档
看看 Git 眼里的状态(真实输出):
% git status --short
?? .env
?? __pycache__/?? 表示「没被管起来的新文件」。这时候一句 git add . 就会把它们全加进去。
在项目文件夹里新建一个叫 .gitignore 的文件(注意前面有个点),写上:
.env
__pycache__/
.venv/每行一个名字,结尾带 / 的表示文件夹。再看状态:
% git status --short
?? .gitignore.env 和 __pycache__/ 不见了,Git 当它们不存在。只剩 .gitignore 自己,它是要存档的,这样换台电脑克隆下来也有同样的规则:
% git add .gitignore
% git commit -m "加上 .gitignore:Key 和缓存不进仓库"
[main a89b6b7] 加上 .gitignore:Key 和缓存不进仓库
1 file changed, 3 insertions(+)
create mode 100644 .gitignore不确定某个文件有没有被忽略,可以问 Git:
% git check-ignore -v .env
.gitignore:1:.env .env意思是:.env 被 .gitignore 第 1 行的规则忽略了。
先写 .gitignore,再 git add .
新项目第一步就写 .gitignore。Python 项目至少放这三行;用了别的工具,就把它生成的缓存、日志、虚拟环境文件夹加进去。GitHub 建仓库时也可以直接选一个现成的 Python 模板。
5.2 已经提交过的 Key:删文件不管用
.gitignore 只管还没被存档的文件。如果 Key 已经被 commit 过,再加进 .gitignore、甚至把那行代码删掉,都晚了。
我在另一个演示仓库里模拟了一次:先把一个假 Key 写进 config.py 存档,第二个存档改成从环境变量读。现在的文件里已经没有 Key 了:
% cat config.py
import os; KEY = os.environ["DEEPSEEK_API_KEY"]可翻一下历史:
% git log -p --oneline | grep 'sk-'
-KEY = "sk-演示用假Key-123"
+KEY = "sk-演示用假Key-123"第一个存档里加进去(+),第二个存档里删掉(-),两次都完整地留在历史里。仓库推到 GitHub 上,任何人都能翻到。
所以 Key 一旦被提交过,正确的做法是:
- 立刻去平台把这个 Key 删掉(DeepSeek 开放平台的「API keys」页),重新创建一个。这一步最重要,做完以后旧 Key 就算被人拿到也没用了
- 新 Key 放进环境变量或
.env,并确认.env在.gitignore里 - 清理 Git 历史是另一件复杂的事,新手不必做:Key 已经作废,留在历史里也没有危害
别指望「赶紧删掉再推一次」
删掉文件再推送,只是新加了一个存档,旧的那个还在。哪怕把仓库设成私有、甚至删掉仓库,你也无法确认这期间有没有被人拿走。唯一可靠的是让旧 Key 作废。
5.3 推到 GitHub
GitHub 是放 Git 仓库的网站:你的存档在那儿有一份备份,换电脑、和别人协作都方便。
第 1 步:在 GitHub 上建一个空仓库。 登录 github.com,右上角「+」→「New repository」,名字填 weekly-report,选 Private(私有),其他选项都不勾(本地已经有文件了),点「Create repository」。
第 2 步:把本地仓库和它连起来,推上去。 建好后页面上会给出命令,大致是这样(你的用户名 换成自己的):
git remote add origin https://github.com/你的用户名/weekly-report.git
git push -u origin main| 命令 | 意思 |
|---|---|
git remote add origin 地址 | 给这个仓库登记一个远程地址,起名叫 origin |
git push -u origin main | 把本地的 main 推到 origin;-u 让以后直接 git push 就行 |
第一次推送会要求登录 GitHub。Windows 版 Git 一般会弹出浏览器窗口让你授权,点同意就行。如果终端直接要你输入用户名和密码,输入账户密码是推不上去的(GitHub 早就不支持了):最省事的办法是装 GitHub 官方的命令行工具 gh,运行 gh auth login 按提示在浏览器里登录一次。之后每次存了新档,git push 一下就同步上去了。
推上去以后,刷新 GitHub 页面,看一眼文件列表:.env 不在里面,这就对了。
私有仓库也别放 Key
私有仓库只有你能看,但它照样可能因为误操作变成公开、或者被你邀请的人看到。Key 永远只放在你自己电脑的环境变量或 .env 里。
试一试
- [ ] 在
weekly-report里建.gitignore,用git status --short确认.env消失了 - [ ] 用
git check-ignore -v .env验证一下 - [ ] 在 GitHub 上建一个私有仓库,把
weekly-report推上去,确认网页上看不到.env
本章小结
| 要点 | 说明 |
|---|---|
.gitignore | 每行一个名字,Git 当它们不存在;新项目第一步就写 |
| 检查 | git status --short 看还剩什么;git check-ignore -v 文件 看为什么被忽略 |
| 提交过的 Key | 删文件不管用,历史里还在;立刻去平台作废、换新 |
| 推到 GitHub | 建私有空仓库 → git remote add origin 地址 → git push -u origin main |
下一章预告
终端、路径、环境变量、Git、GitHub,零件都齐了。最后一章把它们串成一套流程,再讲讲和 AI 编程工具一起干活时,Git 怎么帮你兜底。