前置准备#

1. 安装 Node.js 20 LTS + Git
2. 安装包管理器 pnpm（终端执行）

1
npm install -g pnpm

1. GitHub 账号、Cloudflare 免费账号

方式 A：命令行一键生成新项目（推荐）#

1
pnpm create fuwari@latest
2
# 项目名称随便填，例如 my-blog
3
cd my-blog
4
pnpm install
5
# 本地启动预览
6
pnpm dev

打开浏览器访问 http://localhost:4321，立刻看到博客效果。

1
export const siteConfig: SiteConfig = {
2
  title: "我的技术博客",
3
  subtitle: "随便写写开发笔记",
4
  lang: "zh_CN", // 设置中文
5
  themeColor: {
6
    hue: 210, // 主题色调 0红 / 120绿 / 210蓝 / 340粉，可以自由修改
7
    fixed: false,
8
  },
9
  // 下方还有社交链接、导航菜单，按需删掉/修改
10
}

1
pnpm new-post test-article

上传代码到 GitHub#

1. GitHub 新建仓库，名称自定义（不要勾选 readme）
2. 项目目录终端执行：

1
git init
2
git add .
3
git commit -m "init blog"
4
git remote add origin https://github.com/你的用户名/仓库名.git
5
git branch -M main
6
git push -u origin main

Cloudflare Pages 部署【关键配置】#

1. 打开 https://dash.cloudflare.com → Workers & Pages → Create application → Pages → Connect to Git
2. 授权 GitHub，选中刚刚创建的仓库 → Begin setup
3. 填写构建设置（照着复制）

• Framework preset：Astro
• Production branch：main
• Build command：pnpm build
• Build output directory：dist
• Root directory：留空

1. 点击 Save and Deploy

等待 2～3 分钟构建完成，Cloudflare 会分配地址：xxx.pages.dev，你的博客上线！

之后每次本地写完文章，git push 到 GitHub，Cloudflare 自动重新构建部署。