部署到 Cloudflare Pages

Cloudflare Pages 官方 VitePress 预设使用以下构建设置：

配置项	值
Framework preset	VitePress
Production branch	`main`
Build command	`npx vitepress build`
Build output directory	`.vitepress/dist`

官方参考：https://developers.cloudflare.com/pages/framework-guides/deploy-a-vitepress-site/

本项目的 package.json 也提供了等价命令：

bash

npm run build

方式一：Git 集成

把本项目推送到 GitHub 仓库。
打开 Cloudflare Dashboard。
进入 Workers & Pages。
选择 Create application。
进入 Pages 标签。
选择 Import an existing Git repository。
选择你的仓库并开始配置。
Framework preset 选择 VitePress。
确认构建命令和输出目录：

text

Build command: npx vitepress build
Build output directory: .vitepress/dist

点击部署，等待 Cloudflare 完成首次构建。

方式二：Wrangler 直接上传

如果你已经登录 Wrangler，可以直接执行：

bash

npm run deploy

等价命令是：

bash

npm run build
npx wrangler pages deploy .vitepress/dist --project-name hideapps-docs

首次部署时，如果 Cloudflare 账户里还没有 hideapps-docs Pages 项目，Wrangler 会引导创建。

推荐项目名称

建议 Cloudflare Pages 项目名称使用：

text

hideapps-docs

这样默认预览域名会类似：

text

hideapps-docs.pages.dev

生产访问仍以 https://docs.hideapps.top 为准。

当前项目部署状态

本教程项目已经创建 Cloudflare Pages 项目：

text

hideapps-docs

Pages 默认访问地址：

text

https://hideapps-docs.pages.dev