概述

布局插槽十分实用，但有时候你可能会觉得它不够灵活。主题同样提供了单个组件覆写的能力。

注意

在使用此功能前，你应该首先熟悉本主题的源代码，了解 主题内置的各个组件，以便 安全的 覆写他们。

主题的组件源代码托管在 GitHub，遵循 MIT 协议。

使用

主题将所有 非全局的组件 都注册了一个带 @theme 前缀的 alias 。 例如，VPFooter.vue 的别名是 @theme/VPFooter.vue 。

如果你想要覆写 VPFooter.vue 组件，只需要在配置文件 .vuepress/config.ts 中覆盖这个别名即可：

.vuepress/config.ts

import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
import { getDirname, path } from 'vuepress/utils'

const __dirname = getDirname(import.meta.url)

export default defineUserConfig({
  theme: plumeTheme(),

  alias: {
    '@theme/VPFooter.vue': path.resolve(
      __dirname,
      './components/MyFooter.vue',
    ),
  },
})

贡献者

pengzhanbo

更新日志

2025/10/7 15:13

查看所有更新日志

• 4d236-feat(theme)!: add collections support (#704)于 2025/10/7
• 0fd6c-refactor(theme): improve types and flat config (#524)于 2025/3/15
• 6e6f9-docs: improve docs (#509)于 2025/3/2
• 597a1-style: lint fix于 2024/11/29
• 520dc-style: lint fix于 2024/9/10
• b079a-docs: update docs于 2024/6/17