部署文档站

本站是 VitePress 静态站点。构建时会把 Markdown 预渲染为 HTML，并输出带内容哈希的 JS/CSS 资源，因此不需要常驻 Node.js 服务、数据库或服务端渲染。

本地构建

bash

npm ci
npm run docs:build
npm run docs:preview

生产站点默认使用 https://docs.anibaka.com 生成 sitemap 与社交分享图片地址。预览或镜像部署可通过 DOCS_ORIGIN 覆盖。

连接 Git 仓库，自动构建、预览 PR 并发布到 pages.dev。适合纯文档站的零维护部署。

用 Workers Static Assets 直接上传预渲染产物。仓库已包含 wrangler.jsonc。

通过 Actions 上传静态产物；项目站点需要设置正确的 DOCS_BASE。

使用相同构建命令和输出目录，不需要框架适配器或 Serverless Function。

默认 base 为 /。部署到 https://user.github.io/repository/ 之类的子路径时：

bash

DOCS_BASE=/repository/ npm run docs:build

PowerShell：

powershell

$env:DOCS_BASE='/repository/'
npm run docs:build

自定义域名通常仍使用 /。

VitePress 的构建资源文件名包含哈希，可以长期 immutable 缓存；HTML 应使用较短缓存或 revalidate。不要开启会删除 HTML 注释的自动压缩功能，Vue hydration 可能依赖这些注释。