配置
VitePress 的配置文件位于 docs/.vitepress/config.ts。
基础配置
typescript
import { defineConfig } from 'vitepress'
export default defineConfig({
// 网站标题
title: '我的网站',
// 网站描述
description: '一个简洁的个人门户',
// 语言
lang: 'zh-CN',
// 基础路径
base: '/',
// 输出目录
outDir: '../dist'
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
主题配置
typescript
export default defineConfig({
themeConfig: {
// 导航栏
nav: [
{ text: '首页', link: '/' },
{ text: '指南', link: '/guide/' }
],
// 侧边栏
sidebar: {
'/guide/': [
{
text: '指南',
items: [
{ text: '介绍', link: '/guide/' },
{ text: '快速开始', link: '/guide/getting-started' }
]
}
]
},
// 社交链接
socialLinks: [
{ icon: 'github', link: 'https://github.com' }
],
// 搜索
search: {
provider: 'local'
},
// 页脚
footer: {
message: '基于 VitePress 构建',
copyright: '© 2026 我的网站'
}
}
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
Markdown 配置
typescript
export default defineConfig({
markdown: {
// 显示行号
lineNumbers: true,
// 支持 emoji
emoji: true
}
})
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
Vite 配置
typescript
export default defineConfig({
vite: {
// 开发服务器
server: {
host: '0.0.0.0',
port: 5173
},
// 构建配置
build: {
outDir: '../dist',
assetsDir: 'assets'
}
}
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
更多配置
请参考 VitePress 官方文档。