Cloudflare Workers 博客多设备同步与 Git 管理教程

记录我在多台电脑之间管理 Cloudflare Workers 博客的完整流程，避免下次换电脑时手忙脚乱。

一、背景问题

我在公司电脑上创建了一个 Workers 博客，用 Wrangler 部署到 Cloudflare。回到家后想接着编辑，结果发现：

• Wrangler 没有“从云端下载已部署代码”的直接命令
• 用 npm create cloudflare@latest -- --type=pre-existing 拉取时，如果 Worker 带静态资源（Assets），会报错：

X [ERROR] `wrangler init --from-dash` is not yet supported for Workers with Assets

结论：不要依赖从 Cloudflare 反拉代码，正确做法是用 Git 管理源码。

二、核心原则

1. Git 仓库是唯一事实来源，本地和云端都从 Git 走。
2. 换电脑 → git clone
3. 改完代码 → git push + npx wrangler deploy
4. 不要在 Dashboard 网页上直接改代码，否则和本地会冲突。

三、新电脑首次配置

1. 安装 Node.js

去 nodejs.org 下载 LTS 版本，安装后重启终端，验证：

node -v
npm -v

2. 安装 Git

去 git-scm.com 下载安装。

3. 登录 Cloudflare

npx wrangler login

浏览器会弹出授权页面，登录你的 Cloudflare 账号。

四、从 GitHub 克隆博客项目

cd /d D:\
# 如果是Git Bash命令
cd /d/目录
git clone https://github.com/你的用户名/Do-Blog.git
cd Do-Blog
npm install

克隆后本地就有了完整源码，可以开始编辑。

五、日常修改与部署流程

1. 修改代码

用编辑器（VS Code 等）打开项目，编辑 src 里的代码或静态文件。

2. 本地预览

npx wrangler dev

浏览器打开提示的本地地址，确认效果。

3. 提交到 Git

git add .
git commit -m "描述这次改了什么"
git push

4. 部署到 Cloudflare

npx wrangler deploy

部署成功后，线上博客就更新了。

六、多仓库绑定（可选）

如果一个本地项目要推送到多个远程仓库，用不同别名区分：

git remote add cfblog https://github.com/你的用户名/cfblog.git
git remote add doblog https://github.com/你的用户名/Do-Blog.git

推送时分别指定：

git push cfblog main
git push doblog main

查看当前绑定：

git remote -v

七、Git 首次初始化流程（新建项目时用）

如果本地已有代码，但还没绑定 GitHub 仓库：

cd /d D:\你的项目目录
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/你的用户名/Do-Blog.git
git push -u origin main

八、必须注意的坑

1. 忽略 node_modules

在项目根目录新建 .gitignore 文件，写入：

node_modules/
.wrangler/
.dev.vars

否则仓库会变得巨大。

2. 不要用 C3 从 Dashboard 拉代码

--type=pre-existing 只适合纯代码 Worker，带 Assets 的会直接报错。

3. Worker 名称要一致

wrangler.toml 或 wrangler.jsonc 里的 name 必须和 Cloudflare 上的 Worker 名称完全一致，否则部署会失败。

4. 分支名统一用 main

git branch -M main

避免 master / main 混乱。

5. 换电脑不要重复 git init

已有仓库的目录，直接 git clone，不要再 git init。

九、换电脑速查清单

十、一句话总结

代码归 Git 管，部署归 Wrangler 管，Cloudflare 云端只是部署目标，不要试图从云端反拉源码。