单页应用（SPA）需通过服务端渲染（SSR）、预渲染或动态渲染使爬虫获取完整HTML，辅以语义化标签、动态元信息、规范路由及Sitemap等基础SEO实践来提升搜索引擎收录效果。
单页应用（SPA）默认对搜索引擎不友好，因为传统爬虫难以执行 JavaScript 渲染页面内容。要让搜索引擎收录 SPA，核心思路是：让爬虫能获取到完整的、带有语义化 HTML 的页面内容。以下是实用、可落地的优化方法。
服务端渲染（SSR）
在服务器端预先执行 JavaScript，生成完整的 HTML 字符串返回给客户端和爬虫。这是最直接有效的方案。
- 使用 Next.js（React）、Nuxt.js（Vue）、Angular Universal 等框架，它们内置 SSR 支持，配置简单、生态成熟
- 确保关键内容（如标题、正文、元描述）在首屏 HTML 中真实存在，而非依赖 JS 后续插入
- 注意动态路由需在服务端正确匹配并渲染，避免返回空模板或 404
预渲染（Prerendering）
适用于内容更新不频繁的站点，构建时生成静态 HTML 文件，部署后直接由服务器返回。
DeepBI DHTML 页面生成器
下载
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- 工具如 Prerender.io、react-snapshot、vue-prerender-spa-plugin 可在构建阶段模拟浏览器访问并保存快照
- 适合营销页、博客、产品介绍页等静态或半静态内容
- 需配合 CI/CD 自动触发重新预渲染，否则新内容不会生效
动态渲染（Dynamic Rendering）
根据 User-Agent 区分请求来源：对真实用户返回 SPA，对搜索引擎爬虫返回 SSR 或预渲染后的 HTML。
立即学习“Java免费学习笔记（深入）”；
- 需在反向代理层（如 Nginx、Cloudflare Worker）或 Node.js 中间件中识别爬虫 UA（如 Googlebot、Bingbot）
- 注意保持前后端内容一致，避免被判定为“隐藏内容”或 cloaking（违规操作）
- 适合已有大型 SPA 难以重构、又急需 SEO 支持的场景
基础前端增强与规范
即使采用 SSR 或预渲染，仍需做好基础 SEO 工程实践，确保结构清晰、可读性强。
- 每个路由对应唯一 URL，使用 HTML5 History API（不是 hash 模式），避免 # 开头路径
- 用
和 动态更新，推荐通过 React Helmet、Vue Meta 等库统一管理 - 为图片添加 alt 属性，重要内容用语义化标签（h1~h6、article、section）包裹
- 提供清晰的 Sitemap.xml，并在 robots.txt 中声明，帮助爬虫发现页面
