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 ![CAN 总线接线示意图](/media/can-bus-wiring.png) ``` ## 技术 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),可以获得双重流量收益。 :::