用 Git + GitHub 备份 Cloudflare Workers 项目

实操记录：把包含 public/ 静态资源的 Workers 项目，用 Git 做版本控制并备份到 GitHub。环境：Windows + Git Bash。

一、为什么用 Git

Wrangler 没有”备份 Worker”的命令，备份靠 本地项目 + Git：

每次改动都有快照，随时回退
云端备份（GitHub / GitLab / Gitee）
public/ 等静态资源一起纳入版本管理

二、准备工作

1. 安装 Git

Windows：https://git-scm.com/download/win （自带 Git Bash）
macOS：brew install git
Linux：sudo apt install git

验证：git --version

2. 配置用户名和邮箱（只需一次）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

只是提交记录里的署名，不是登录密码
user.email 建议填 GitHub 绑定邮箱，提交才会关联到你的账号
--global 对本机所有仓库生效

三、初始化 Git

进入项目根目录（有 wrangler.toml 和 public/ 的那一层）：

cd /d/cfblog
git init
git status

此时会看到 .wrangler/、backup.sql 也在未跟踪列表里——它们不该提交，下一步处理。

四、写 `.gitignore`（关键）

创建文件：

touch .gitignore

写入内容：

# 依赖
node_modules/

# Wrangler 缓存
.wrangler/

# 构建输出
dist/

# 环境变量与密钥
.env
.env.*
.dev.vars

# 数据库备份（含敏感数据）
backup.sql
*.sql

# 系统文件
.DS_Store
Thumbs.db

# 日志
*.log

验证：再次 git status，如果 .wrangler/ 和 backup.sql 消失了就生效了。

注意事项：

❌ 不要把 public/ 写进 .gitignore，否则静态资源不会被备份
❌ 不要提交 .env、*.sql、密钥文件
✅ 想强制提交被忽略的文件：git add -f 文件名
⚠️ Windows 记事本改名可能变成 .gitignore.txt，用 touch 或 VS Code 创建

点击展开▾

五、第一次提交

git add .
git commit -m "初始化项目，包含 public 静态资源"
git log --oneline    # 查看历史

六、推送到 GitHub

1. 建空仓库

GitHub → + → New repository：

填仓库名
不要勾选 README / .gitignore / license

2. 本地关联并推送

git branch -M main
git remote add origin https://github.com/你的用户名/你的仓库名.git
git push -u origin main

第一次推送会提示登录 GitHub（浏览器授权）。

推送成功后刷新页面，能看到 public/、src/、.gitignore、wrangler.toml，没有 .wrangler/ 和 backup.sql ✅

七、改成私有仓库（推荐）

仓库页面 → Settings
滚到页面最底部 → Danger Zone
Change repository visibility → Make private

改完本地 git push 不受影响。

⚠️ 如果曾公开过，检查 wrangler.toml 里有没有密钥，有的话立即作废重发。

八、日常流程

git add .
git commit -m "描述改动"
git push

只提交 public/：

git add public/
git commit -m "更新 public 静态资源"
git push

九、常用操作速查

操作	命令
恢复被删的 `public/`	`git checkout HEAD -- public/`
恢复单个文件	`git checkout HEAD -- public/style.css`
回退到某次提交	`git checkout <commit-hash> -- public/`
查看历史	`git log --oneline`
撤销未提交修改	`git checkout -- 文件名`
误提交敏感文件	`git rm --cached .env`
改远程地址	`git remote set-url origin <新地址>`
开分支试验	`git checkout -b feature/xxx`

十、完整流程速查

# 一次性初始化
git init
touch .gitignore        # 排除 .wrangler/、backup.sql，保留 public/
git add .
git commit -m "初始化"
git branch -M main
git remote add origin <仓库地址>
git push -u origin main

# 日常
git add .
git commit -m "说明"
git push

十一、核心提醒

public/ 不能写进 .gitignore，否则不会被备份
密钥、.env、*.sql 绝不提交，一旦推上去即使删除也可能被抓走
.git 文件夹别删，删了历史就没了
提交信息写清楚，”修复首页 CSS” 比 “update” 有用
Git 只管备份，不影响 wrangler deploy
备份项目建议直接建 Private 仓库

十二、更新推送

命令cd /d/cfblog进入项目目录再操作
# 1. 看看这次改动了哪些文件
git status
git diff

# 2. 把改动加入暂存区（.gitignore 已经生效的话，敏感文件不会被加进来）
git add .

# 3. 提交，写一句说明
git commit -m "更新 Workers：xxx 功能"

# 4. 如果之前已经配过远程仓库，直接推
git push