开始之前

这套教程的目标是把 VitePress 文档站发布到 Cloudflare Pages，并使用生产域名：

https://docs.hideapps.top

你需要准备

• 一个可以推送代码的 Git 仓库，建议使用 GitHub。
• 一个 Cloudflare 账号。
• hideapps.top 的 DNS 管理权限。如果域名已经接入 Cloudflare，后续 CNAME 记录会更容易处理。
• 本地 Node.js 环境。建议使用 Cloudflare Pages 当前构建镜像支持的稳定 Node 版本，并在 Pages 环境变量中显式设置。

当前项目结构

.
├─ .vitepress/
│  ├─ config.mts
│  └─ theme/
├─ guide/
├─ reference/
├─ public/
├─ package.json
└─ wrangler.toml

本地命令

安装依赖：

npm install

启动开发服务器：

npm run dev

构建静态站点：

npm run build

构建产物会输出到：

.vitepress/dist

下一步：创建并完善 VitePress 项目内容。