Skip to content

第 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 眼里的状态(真实输出):

text
% git status --short
?? .env
?? __pycache__/

?? 表示「没被管起来的新文件」。这时候一句 git add . 就会把它们全加进去。

在项目文件夹里新建一个叫 .gitignore 的文件(注意前面有个点),写上:

text
.env
__pycache__/
.venv/

每行一个名字,结尾带 / 的表示文件夹。再看状态:

text
% git status --short
?? .gitignore

.env 和 __pycache__/ 不见了,Git 当它们不存在。只剩 .gitignore 自己,它是要存档的,这样换台电脑克隆下来也有同样的规则:

text
% git add .gitignore
% git commit -m "加上 .gitignore:Key 和缓存不进仓库"
[main a89b6b7] 加上 .gitignore:Key 和缓存不进仓库
 1 file changed, 3 insertions(+)
 create mode 100644 .gitignore

不确定某个文件有没有被忽略,可以问 Git:

text
% 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 了:

text
% cat config.py
import os; KEY = os.environ["DEEPSEEK_API_KEY"]

可翻一下历史:

text
% git log -p --oneline | grep 'sk-'
-KEY = "sk-演示用假Key-123"
+KEY = "sk-演示用假Key-123"

第一个存档里加进去(+),第二个存档里删掉(-),两次都完整地留在历史里。仓库推到 GitHub 上,任何人都能翻到。

所以 Key 一旦被提交过,正确的做法是:

  1. 立刻去平台把这个 Key 删掉(DeepSeek 开放平台的「API keys」页),重新创建一个。这一步最重要,做完以后旧 Key 就算被人拿到也没用了
  2. 新 Key 放进环境变量或 .env,并确认 .env 在 .gitignore 里
  3. 清理 Git 历史是另一件复杂的事,新手不必做:Key 已经作废,留在历史里也没有危害

别指望「赶紧删掉再推一次」

删掉文件再推送,只是新加了一个存档,旧的那个还在。哪怕把仓库设成私有、甚至删掉仓库,你也无法确认这期间有没有被人拿走。唯一可靠的是让旧 Key 作废。


5.3 推到 GitHub ​

GitHub 是放 Git 仓库的网站:你的存档在那儿有一份备份,换电脑、和别人协作都方便。

第 1 步:在 GitHub 上建一个空仓库。 登录 github.com,右上角「+」→「New repository」,名字填 weekly-report,选 Private(私有),其他选项都不勾(本地已经有文件了),点「Create repository」。

示意图:GitHub 新建仓库页面,名字填 weekly-report,选 Private,README、.gitignore、license 都不加,点 Create repository

第 2 步:把本地仓库和它连起来,推上去。 建好后页面上会给出命令,大致是这样(你的用户名 换成自己的):

bash
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 怎么帮你兜底。

👉 第 6 章:实操:和 AI 编程工具一起用

本文阅读--次|全站访问--次|访客--人