vuepress2 配置

基本配置

VuePress 站点的基本配置文件是 .vuepress/config.js ，但也同样支持 TypeScript 配置文件。

配置文件优先级：

1. 当前工作目录 cwd 下：

• vuepress.config.ts
• vuepress.config.js
• vuepress.config.mjs

2. 源文件目录 sourceDir 下：（如 docs）

• .vuepress/config.ts
• .vuepress/config.js
• .vuepress/config.mjs

命令行接口指定配置文件：

vuepress dev docs --config my-config.ts

所有的配置项都可以在 配置 | VuePress (vuejs.org) 中找到。

示例

import { viteBundler } from '@vuepress/bundler-vite'
import { defaultTheme } from '@vuepress/theme-default'
import { defineUserConfig } from 'vuepress'

export default defineUserConfig({
  bundler: viteBundler(),
  theme: defaultTheme(),

  lang: 'zh-CN',
  title: '你好， VuePress ！',
  description: '这是我的第一个 VuePress 站点',
})

客户端配置

在大多数情况下，配置文件已经足够帮助你配置好你的 VuePress 站点。不过，有些时候用户们可能希望直接添加一些客户端代码。 VuePress 通过客户端配置文件来支持这种需求：

├─ docs
│  ├─ .vuepress
│  │  ├─ client.js   <--- 客户端配置文件
│  │  └─ config.js   <--- 配置文件
│  └─ README.md
├─ .gitignore
└─ package.json

同样的，我们也有关于客户端配置文件的路径约定（按照优先顺序）：

1. 当前工作目录 cwd 下：

• vuepress.client.ts
• vuepress.client.js
• vuepress.client.mjs

2. 源文件目录 sourceDir 下：

• .vuepress/client.ts
• .vuepress/client.js
• .vuepress/client.mjs

示例

import { defineClientConfig } from 'vuepress/client'

export default defineClientConfig({
  enhance({ app, router, siteData }) {},
  setup() {},
  rootComponents: [],
})