部署教程：把网站发布出去

部署就是把本地项目发布到网上，让别人可以通过网址访问。

一、部署前检查

先进入项目根目录，也就是有 package.json 的文件夹，再运行：

npm install
npm run build

如果构建失败，先修复报错，不要急着部署。构建成功后，终端通常会显示输出目录。VitePress 文档站常见输出目录是 docs/.vitepress/dist。

二、常见部署平台

平台	适合场景
Vercel	前端项目、文档站、个人网站
GitHub Pages	静态网站、开源项目文档
Cloudflare Pages	静态网站、全球访问

三、Vercel 部署思路

1. 把代码提交到 GitHub
2. 登录 Vercel
3. 导入 GitHub 仓库
4. 设置构建命令
5. 设置输出目录
6. 点击部署

VitePress 常见配置：

配置项	值
Build Command	npm run build
Output Directory	docs/.vitepress/dist

这两个值的前提是：部署平台的 Root Directory 选的是仓库根目录。如果你把 Root Directory 改成 docs，输出目录就可能变成 .vitepress/dist。不确定时，以本地 npm run build 后实际生成的目录为准。

四、GitHub Pages 部署思路

适合静态文档站。常见流程：

1. 代码推送到 GitHub
2. 配置 GitHub Actions
3. 构建 VitePress
4. 发布到 Pages

如果你不熟悉 Actions，建议先用 Vercel。

VitePress 部署到 GitHub Pages 时要特别注意 base。如果访问地址是：

https://你的用户名.github.io/仓库名/

通常需要在 docs/.vitepress/config.mts 里配置：

export default defineConfig({
  base: '/仓库名/',
})

如果不配置，部署后可能出现页面能打开，但样式、脚本或图片 404 的情况。

五、部署后页面没更新

排查：

• 最新代码是否 push 到 GitHub
• 部署平台是否触发新构建
• 构建是否成功
• 浏览器是否缓存旧页面
• 输出目录是否配置正确
• 如果是 GitHub Pages，base 是否配置正确

六、域名绑定

如果你有自己的域名，可以在部署平台里绑定。

一般需要：

• 在平台添加域名
• 到域名服务商修改 DNS
• 等待解析生效

如果不会配置 DNS，先不要乱改，截图给 AI 或技术人员看。

七、让 AI 帮你部署前检查

请帮我检查这个 VitePress 项目是否适合部署到 Vercel。请确认构建命令、输出目录和可能的配置问题。