用 Astro + Cloudflare Workers + VS Code 搭建内容站

这篇只保留最初那一步：先把站点跑起来，再部署出去。

准备

• Cloudflare 账号
• Node.js 22.12 或更高
• VS Code

创建项目

在 VS Code 终端里运行：

npm create cloudflare@latest -- astro-site --framework=astro
cd astro-site
npm run dev

浏览器打开终端给出的本地地址，通常是：

http://localhost:4321/

当前项目最少需要知道的文件

初始化完成后，先确认这几处：

• package.json
• astro.config.mjs
• wrangler.jsonc
• src/pages/
• src/content.config.ts

当前仓库已经采用 @astrojs/cloudflare 适配器，并通过 wrangler.jsonc 作为 Workers 部署入口配置。

本地开发

常用命令：

npm run dev
npm run build
npm run preview

部署到 Cloudflare Workers

首次部署前先登录：

npx wrangler login

然后部署：

npm run deploy

到这里为止

最小闭环就完成了：

• Astro 项目已经创建
• 本地开发已经可用
• Cloudflare Workers 已经可以接部署

后面的内容模型、双语路由、主题切换、系列系统和组件拆分，分别放到后续专题文章里讲。