VitePress SEO 优化方法

VitePress SEO 优化方法

1. 配置页面元数据

让搜索引擎通过页面的标题、描述、关键词等信息理解页面内容，有助于提升排名。

在 Markdown 文件中使用 frontmatter 定义页面元数据。
每个页面都可以在头部写入 Frontmatter 来定义标题和描述。

---
title: 我的页面标题
description: 这是一个关于 VitePress SEO 优化的页面描述，简洁且包含关键词。
---

title：不超过 60 字符，包含页面关键词

description：不超过 160 字符，应吸引读者点击

每个页面最好都具有独立的 title 和 description，提高 SEO 相关性

全局设置默认元数据

编辑 .vitepress/config.js：

export default {
  title: '站点名称',
  description: '站点描述，简洁且富含关键词',
  head: [
    ['meta', { name: 'keywords', content: 'VitePress, SEO, 文档, 前端' }],
    ['meta', { name: 'author', content: '你的名字' }],
    ['meta', { name: 'viewport', content: 'width=device-width, initial-scale=1' }]
  ]
}

启用 robots.txt

作用是告诉搜索引擎哪些页面允许抓取，哪些不允许。
在 docs/public/ 文件夹中创建 robots.txt

User-agent: *
Allow: /
Sitemap: https://你的域名/sitemap.xml

VitePress 会自动将 public/ 文件夹的内容复制到最终构建目录 dist/

如果站点部署在子路径（如 /my-site/），必须在 config.js 中设置：

export default {
  base: '/my-site/'
}

生成 Sitemap

帮助搜索引擎快速发现网站所有页面，提高收录速度。

VitePress 原生支持生成站点地图，仅需在配置文件 .vitepress/config.js 中配置 hostname：

import { defineConfig } from 'vitepress';

export default defineConfig({
  sitemap: {
    hostname: 'https://your-domain.com' // 替换为你的实际域名
  }
});

• 效果：构建命令 vitepress build 后，会在输出目录自动生成 sitemap.xml，包含所有页面 URL。
• 验证：部署后访问 https://your-domain.com/sitemap.xml 确认是否生成成功

部署与验证

• 文件位置：
  Sitemap 默认输出到网站根目录（如 dist/sitemap.xml），符合搜索引擎抓取标准。
• 提交搜索引擎：
  登录 Google Search Console / Bing Webmaster Tools，在“站点地图”栏目提交 sitemap.xml 的完整 URL。
• 验证工具：
  使用在线工具（如 https://www.xml-sitemaps.com/validate-xml-sitemap.html）检查格式有效性