Skip to content

快速开始

本指南将帮助你快速上手VitePress网站。

开发环境

确保你已经安装了Node.js(推荐v18或更高版本)。

启动开发服务器

bash
npm run docs:dev

开发服务器将在 http://localhost:5173 启动。

构建生产版本

bash
npm run docs:build

构建后的文件将输出到 docs/.vitepress/dist 目录。

预览生产版本

bash
npm run docs:preview

这将启动一个本地服务器来预览构建后的网站。

添加新页面

  1. docs 目录下创建新的 .md 文件
  2. docs/.vitepress/config.js 中更新导航或侧边栏配置
  3. 保存后即可在开发服务器中看到更新

自定义配置

编辑 docs/.vitepress/config.js 文件来自定义网站配置,包括:

  • 网站标题和描述
  • 导航栏
  • 侧边栏
  • 主题颜色
  • 社交链接

更多配置选项请参考VitePress官方文档