故障排查

构建失败：找不到 vitepress

确认依赖已安装，并且 Cloudflare Pages 会执行安装步骤：

npm install
npm run build

如果你在 Pages 中使用 npx vitepress build，Cloudflare 会根据仓库依赖安装 VitePress。

构建成功但页面 404

检查 Build output directory 是否为：

.vitepress/dist

VitePress 输出目录写错时，Cloudflare Pages 会部署一个空目录或错误目录。

docs.hideapps.top 不能访问

按顺序检查：

1. Pages 项目的 Custom domains 是否已经添加 docs.hideapps.top。
2. DNS 是否存在 docs CNAME。
3. CNAME 目标是否为 Pages 项目的 pages.dev 域名。
4. Cloudflare 是否还在签发或验证证书。

HTTPS 证书长时间未生效

检查 hideapps.top 是否存在限制证书签发的 CAA 记录。如果存在，需要允许 Cloudflare 使用的证书颁发机构签发证书。

本地预览正常，线上样式丢失

本项目部署在子域名根路径 https://docs.hideapps.top/，VitePress 不需要设置 base。如果改为部署到子路径，例如 /docs/，才需要额外配置 base。