SEO 优化
GEO-Wiki Pro 站点的搜索引擎优化最佳实践,提升 Google 等搜索引擎的排名与流量
## 什么是 SEO 优化
SEO(Search Engine Optimization,搜索引擎优化)是通过优化网站内容和技术结构,提升在传统搜索引擎(如 Google、Bing、百度)中自然排名的过程。GEO-Wiki Pro 从架构层面已经为 SEO 做了基础优化,但内容层面仍需作者主动配合。
## 核心要素
### 1. 页面标题与描述
每个文档的 YAML frontmatter 中的 `title` 和 `description` 会自动映射为 HTML 的 `<title>` 和 `<meta name="description">` 标签。
```yaml
---
title: CAN Bus Protocol Reference
description: Complete reference for CAN bus protocol configuration, timing, and troubleshooting
---
```
**最佳实践:**
- title 控制在 50-60 个字符
- description 控制在 120-160 个字符
- 包含核心关键词,但避免堆砌
### 2. URL 结构
GEO-Wiki Pro 使用 `slug` 作为文档 URL,天然支持 SEO 友好的短链接:
- ✅ `/docs/can-bus-protocol` — 简洁、语义清晰
- ❌ `/docs/doc-12345` — 无意义的 ID
### 3. 内容质量
搜索引擎越来越重视内容质量。优质内容的特征:
- **原创性**:提供独特的见解和实践经验
- **深度**:覆盖主题的关键方面,不流于表面
- **可读性**:段落简洁,使用标题和列表组织内容
- **时效性**:定期更新,确保信息准确
### 4. 内部链接
文档之间的相互引用可以增强站点的内部链接结构,帮助搜索引擎理解页面之间的关系。
```markdown
参见 [AI 搜索优化](/docs/ai-search-optimization)了解更多信息。
```
### 5. 图片优化
- 使用描述性的 alt 文本
- 控制图片文件大小(建议 < 500KB)
- 使用 WebP 格式以获得更小的文件体积
```markdown

```
## 技术 SEO
GEO-Wiki Pro 已内置以下技术 SEO 特性:
| 特性 | 实现方式 |
|------|---------|
| Sitemap | `GET /api/v1/geo/sitemap.xml` 自动生成 |
| 语义化 HTML | Vue 组件使用语义化标签 |
| 响应式设计 | Tailwind CSS 确保移动端友好 |
| 页面加载速度 | Vite 构建优化 + 静态资源压缩 |
| robots.txt | 引导搜索引擎爬虫正确索引 |
| 结构化数据 | Schema.org JSON-LD 自动注入 |
## SEO 检查清单
- [ ] 每个页面都有唯一的 title 和 description
- [ ] slug 使用英文小写加连字符
- [ ] 图片都有 alt 文本
- [ ] 内容中适当使用关键词(自然融入,不堆砌)
- [ ] 建立文档之间的内部链接
- [ ] 定期更新内容保持时效性
- [ ] 检查 sitemap.xml 是否包含所有页面
- [ ] 确保页面加载速度 < 3 秒
::: tip
GEO 和 SEO 并不是对立的。做好 SEO 基础优化,同时关注 AI 搜索优化(GEO),可以获得双重流量收益。
:::