南生论坛

主题

maliangnansheng2026-05-12
823
3.4m

SEO 优化清单 ​

本文档记录了所有已实施的 SEO 优化措施。

✅ 已完成的 SEO 优化 ​

1. Meta 标签优化 ​

  • robots meta: 添加 index, follow 指令
  • viewport: 优化移动端显示
  • theme-color: 匹配网站主题色
  • author: 明确网站作者
  • keywords: 添加有针对性的关键词
  • revisit-after: 设置搜索引擎重访频率

2. Open Graph 优化 ​

  • og:type: website
  • og:locale: zh_CN (支持 en_US 备用)
  • og:title: 优化的标题
  • og:site_name: 站点名称
  • og:image: 分享图片
  • og:url: 标准 URL

3. Twitter Cards 支持 ​

  • twitter:card: summary_large_image
  • twitter:title, description, image
  • twitter:site: @maliangnansheng

4. URL 结构优化 ​

  • cleanUrls: true: 启用清洁 URL（无 .html 后缀）
  • 路由已改为英文路径（利于 SEO）：
    • /docs/introduction/introduction
    • /docs/introduction/quickstart
    • /docs/deployment/backend
    • /docs/deployment/frontend
    • /docs/license/commercial
    • /docs/license/tech-stack

5. robots.txt ​

创建了 public/robots.txt，包含：

  • 允许所有搜索引擎爬取
  • 指定 sitemap 位置
  • 设置爬取延迟
  • 针对不同搜索引擎的规则

6. JSON-LD 结构化数据 ​

创建了 components/SeoJsonLd.vue，包含：

  • WebSite Schema: 网站整体信息
  • WebPage Schema: 页面级信息
  • TechArticle Schema: 技术文档信息
  • SoftwareApplication Schema: 软件应用信息
  • SearchAction: 搜索功能支持

7. Canonical 链接 ​

添加了标准 canonical URL，避免重复内容问题。

8. 页面级 SEO 优化 ​

为每个文档页面添加了优化的 description：

  • introduction.md: 南生论坛简介
  • quickstart.md: 快速开始指南
  • backend.md: 后端部署教程
  • frontend.md: 前端部署教程
  • commercial.md: 商用授权说明
  • tech-stack.md: 技术选型指南

9. Sitemap 配置 ​

VitePress 自动生成 sitemap.xml，包含所有页面 URL。

10. 搜索引擎推送脚本 ​

创建了 seo-push.ts，支持：

  • 自动生成所有页面 URL
  • 推送到百度搜索
  • 通知 Google 更新 sitemap

11. GitHub Actions 工作流 ​

创建了 deploy-seo.yml，自动化：

  • 构建网站
  • 部署到 GitHub Pages
  • 推送 URL 到百度
  • 通知 Google

📋 部署后检查清单 ​

  1. ✅ 验证 robots.txt 可访问：https://www.nansin.top/robots.txt
  2. ✅ 验证 sitemap.xml 可访问：https://www.nansin.top/sitemap.xml
  3. ✅ 使用 Google Search Console 提交 sitemap
  4. ✅ 使用百度搜索资源平台提交 sitemap
  5. ✅ 使用结构化数据测试工具验证 JSON-LD

🛠️ 手动推送命令 ​

bash
# 构建文档
pnpm docs:build

# 推送 URL 到搜索引擎
tsx docs/.scripts/seo-push.ts https://www.nansin.top

📊 SEO 最佳实践建议 ​

  1. 持续更新内容：定期更新文档，保持内容新鲜
  2. 外部链接：适当添加高质量外部链接
  3. 图片优化：确保所有图片有 alt 文本
  4. 页面速度：VitePress 已自动优化
  5. 移动友好：网站已响应式设计
  6. HTTPS：确保部署使用 HTTPS
  7. 社交分享：每次更新后手动测试分享功能

🔗 搜索引擎提交入口 ​

📝 注意事项 ​

  1. 百度推送需要有效的 token，请在百度搜索资源平台获取
  2. GitHub Actions 工作流需要配置相应的 secrets
  3. 首次部署后，建议手动提交 sitemap 到各搜索引擎
  4. 结构化数据可能需要几天时间被搜索引擎识别
最近更新