VueVitePress博客

vitepress-theme-vuetom — Vue 博客模板

作者 lnool

基于 VitePress 的主题，提供文档与博客两种风格，代码采用 MIT 许可。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图

桌面端首页1 / 2

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-01查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

基于 VitePress 构建的主题项目

提供文档与博客两种风格，README 中博客风格标注为 Coming soon

仓库内含 docs 与 blog 两个示例目录，可分别本地启动预览

README 提供整体构建与分步构建（clean、build:css、build:vt）命令

集成 Crowdin 多语言工作流命令，用于上传与下载翻译文件

代码采用 MIT 许可，GitHub 与 Gitee 均提供仓库地址

模板详细介绍

vitepress-theme-vuetom 是一个基于 VitePress 构建的主题项目，目标是为站点提供文档与博客两种风格。仓库 README 说明主题包含文档风格与博客风格两类主题，其中文档风格已有在线示例（tomhub.cn），博客风格在 README 中标注为 Coming soon。

项目以主题包形式组织，README 给出了从克隆仓库、安装依赖、构建主题到发布主题包的完整命令流程，并区分了整体构建与分步构建（清理、打包样式、打包主程序）。同时仓库内提供 docs 与 blog 两个示例目录，可分别启动文档示例与博客示例进行本地预览。

README 还记录了文档目录多语言的 Crowdin 工作流命令，用于列出、上传与下载翻译文件（如 en-US、zh-TW）。仓库地址同时提供 GitHub 与 Gitee 镜像，许可为 MIT，允许使用、修改、商用与分发该版本代码，但演示图片、字体、图标等第三方素材需按各自许可单独核对。

VueVitePress博客

适合你的项目吗？

适用场景

为 VitePress 站点套用文档风格主题
参考仓库中的 docs 示例搭建文档站点
参考仓库中的 blog 示例目录了解博客风格的实现方式
通过 Crowdin 命令管理文档目录的多语言翻译文件

适合人群

使用 VitePress 搭建文档站点的开发者
希望在同一主题下同时考虑文档与博客形态的项目
需要为文档目录接入 Crowdin 多语言流程的团队

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
克隆仓库后使用 pnpm install 安装依赖
2
使用 pnpm build 构建主题，或按 clean、build:css、build:vt 分步构建
3
进入 docs 或 blog 目录执行 npm run dev 启动对应示例
4
发布主题包使用 pnpm pub
5
多语言相关命令包括 crowdin:list、crowdin:upload、crowdin:dryrun、crowdin:us、crowdin:tw

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

博客风格主题尚未发布，README 标注为 Coming soon，当前仅文档风格可用。
多语言翻译流程依赖 Crowdin 外部服务，使用相关命令需具备 Crowdin 账号与项目配置。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

博客风格(Coming soon...)
README 原文

查看项目文件列表 ```shell $ crowdin:list ```
README 原文

https://github.com/lnool/vitepress-theme-vuetom/blob/mini/LICENSE https://github.com/lnool/vitepress-theme-vuetom/blob/mini/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料一般 · 70 / 100
技术栈: Vue · VitePress
网站类型: 博客

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2022-05-29
截图检查日期: 2026-10-01

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Vue。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: c4cfb4924f6c87edd8c6e6d11393339acad17e0b20cc353eb89ee2e5ed2fe00f

2026-10-01T04:06:39.026Z

来源文件 / 仓库


<p align="center"><a href="https://gitee.com/lauset/vitepress-theme-vuetom" target="_blank" rel="noopener noreferrer"><img width="180" src="https://gitee.com/lauset/vitepress-theme-vuetom/raw/main/docs/public/logo/vuetom-logo.png" alt="logo"></a></p>

<p align="center">
  <a href="https://github.com/xugaoyi/vuepress-theme-vdoing/blob/master/LICENSE"><img src="https://img.shields.io/github/license/xugaoyi/vuepress-theme-vdoing
" alt="License"></a>
  <a href="https://www.npmjs.com/package/vitepress-theme-vuetom"><img alt="npm" src="https://img.shields.io/npm/v/vitepress-theme-vuetom"></a>
</p>

<h2 align="center">vitepress-theme-vuetom</h2>

## 简要说明

1. 基于 vitepress 打造的主题
2. 提供文档与博客两种风格的主题，更多的选择。

[**更新日志**](CHANGELOG.md)

## 主题风格

* [文档风格](http://tomhub.cn)

* 博客风格(Coming soon...)


## 快速上手

- 拉取项目

```bash
git clone https://github.com/lauset/vitepress-theme-vuetom.git

cd vitepress-theme-vuetom
```

- 安装依赖
```bash
pnpm install
```

- 构建主题
```bash
pnpm build
```

- 分步构建
```bash
# 清除文件
pnpm clean

# 打包样式
pnpm build:css

# 打包主程序
pnpm build:vt
```

- 发布主题包
```bash
pnpm pub
```

- 启动文档示例
```bash
cd docs
npm run dev
```

- 启动博客示例
```bash
cd blog
npm run dev
```

## 文档目录多语言

查看项目文件列表

```shell
$ crowdin:list
```

上传待翻译的源文件

```shell
$ crowdin:upload
```

查看预下载文件列表

```shell
$ crowdin:dryrun
```

下载en-US翻译文件

```shell
$ crowdin:us
```

下载zh-TW翻译文件

```shell
$ crowdin:tw
```

## 简单展示

![首页](/resources/pic01.png)

![暗黑主题](/resources/pic02.png)

![语法示例](/resources/pic03.png)

![其他](/resources/pic04.png)

## 仓库地址

[github](https://github.com/lauset/vitepress-theme-vuetom)

[gitee](https://gitee.com/lauset/vitepress-theme-vuetom)

## 感谢

[Vite](https://vitejs.cn/)

[Vitepress](https://vitepress.vuejs.org/)

[ElementPlus](https://element-plus.gitee.io/zh-CN/)

[Crowdin](https://crowdin.com/)

反馈内容错误