文档站点生成器 - VitePress
2026/4/20 20:48:57 网站建设 项目流程

VitePress是一个由ViteVue驱动的静态站点生成器(SSG),专为构建快速、以内容为中心的站点而设计。

适用场景

  1. 技术文档— Vite、Rollup、Pinia、VueUse、Vitest、Vue.js 官方文档等均使用 VitePress
  2. 博客、档案和营销网站— 支持完全自定义主题,可动态生成路由
  3. 组件库文档— 可在 Markdown 中直接渲染 Vue 组件示例

核心特点

特性说明
Vite 驱动即时服务器启动,闪电般的热更新(<100ms),无需重新加载页面
Vue 增强每个 Markdown 页面都是 Vue 单文件组件,可直接在 Markdown 中使用 Vue 语法和组件
Markdown 扩展内置 frontmatter、表格、语法高亮等,支持代码块高级功能
静态 HTML + SPA首次加载为静态 HTML,后续导航使用客户端路由,速度极快

快速开始

# 使用安装向导创建项目npmcreate vitepress@latest# 启动开发服务器npmrun docs:dev# 构建npmrun docs:build

项目结构

docs/ ├── .vitepress/ │ ├── config.ts # 站点配置 │ └── theme/ # 自定义主题 ├── index.md # 首页 ├── guide/ # 文档目录 └── public/ # 静态资源

与 VuePress 的关系

VitePress 是VuePress 的精神继承者。VuePress 基于 Vue 2 和 webpack,而 VitePress 使用 Vue 3 + Vite,在开发体验、生产性能和自定义 API 方面有显著提升。

官方资源

  • 官网: https://vitepress.dev/zh/
  • GitHub: https://github.com/vuejs/vitepress

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询