跳至内容
ZH · $
面板登录 购买套餐
技术 SEO

JavaScript SEO 基础:渲染、SSR 与 CSR 指南

阅读约需 6 分钟

JavaScript SEO是指确保搜索引擎能够正确抓取、执行并索引那些通过 JavaScript 生成内容或链接的网站所做的工作。 在使用 React、Vue、Angular 等框架构建的网站上,您的浏览器中一切可能看起来都完美无缺;但 Googlebot 会在不同条件下、分两个阶段处理同一个页面。 因此,“在我这里能运行”并不足够。本文将介绍谷歌如何处理 JavaScript、不同架构分别带来哪些风险,以及实际中应检查哪些方面。

什么是 JavaScript SEO?

在传统网页中,服务器会直接把内容以 HTML 的形式发送出去。而在以 JavaScript 为主的网站中,服务器通常只发送一个空白框架和一组脚本包;真正的内容要等脚本在浏览器中执行之后才会出现。 从搜索引擎的角度,这就引出了一个问题:机器人能否执行脚本并看到最终内容?何时看到?能有多可靠?

谷歌如今已经能够执行 JavaScript;问题在于这一能力并非无条件、无延迟。以下各部分将说明差异出现在哪些地方。

谷歌如何处理 JavaScript?

谷歌的文档将这一过程描述为三个阶段:

  1. 抓取(crawling):Googlebot 请求地址,获取 HTML 响应,并检查 robots.txt 规则。
  2. 渲染(rendering):页面使用最新的 Chromium 版本执行,并获取 JavaScript 生成的最终内容。此阶段会排队,因此不一定立即完成。
  3. 索引(indexing):渲染后页面中的文本和链接被编入索引;新发现的链接则加入抓取队列。

实际结论是:首次 HTML 中包含的一切,最早且最可靠地被看到。仅通过 JavaScript 添加的内容则要等待渲染队列,并且存在额外风险;如果脚本报错、超时或被屏蔽,内容可能根本不会被看到。

重要:除谷歌以外的搜索引擎以及一些 AI 机器人,可能无法像谷歌那样出色地执行 JavaScript。将网站的关键内容放在首次 HTML 中,对这些机器人同样是最安全的方式。

CSR、SSR 与静态生成

方法工作方式从 SEO 角度看
CSR(客户端渲染)浏览器获取空白框架,内容由脚本生成风险最高的方案;内容依赖渲染阶段
SSR(服务端渲染)服务器在每次请求时生成完整 HTML,随后由浏览器中的脚本接管内容在首次响应中即可获取;对大多数内容型网站是强有力的选择
SSG(静态生成)页面在发布前即生成为 HTML快速且可靠;非常适合不常变化的内容
混合根据页面混合使用 SSR、SSG 或 CSR现代框架的常见做法;关键页面应采用 SSR/SSG

此前曾推荐的“动态渲染”(为机器人单独提供 HTML)方法,谷歌不再将其作为长期解决方案推荐,而是将其定义为一种临时方案。如果您正在开发新项目,选择 SSR 或 SSG 还能减轻维护负担。 请查阅您所用框架(如 Next.js、Nuxt、Astro)的官方文档,了解它们如何提供这些选项。

最常见的 JavaScript SEO 问题

  • 关键内容仅通过 JS 加载:如果标题、产品描述、价格和正文不在首次 HTML 中,就存在风险。
  • JS/CSS 文件被 robots.txt 屏蔽:机器人无法正确渲染页面。请不要屏蔽重要的脚本;要了解这些规则,请参阅我们的 robots.txt 指南。
  • 不是真正链接的导航:仅通过点击事件工作的元素不是可抓取的链接。
  • 滚动或点击后才加载的内容:Googlebot 不会在页面上滚动或点击;位于“显示更多”按钮之后的内容可能不会被看到。
  • 使用哈希(#)的地址:片段标识符(#/urunler)不会被视为不同的页面。
  • 延迟或加载失败的内容:API 响应过慢、超时或脚本报错,都会导致渲染时内容为空。
  • 元标签管理不当:每个页面的 title、description 和 canonical 没有被正确生成。

链接与 URL 结构

谷歌通过 <a> 元素的 href 属性来发现链接。下面两个示例在视觉上效果相同,但只有第一个是可抓取的:

<!-- 可抓取 -->
<a href="https://hitbot.org/urunler/ayakkabi">鞋子</a>

<!-- 不可抓取:没有 href,仅有事件监听器 -->
<span onclick="git('/urunler/ayakkabi')">鞋子</span>

在单页应用(SPA)中,应使用浏览器的 History API 在页面之间切换,并为每个视图创建真实且唯一的地址。每个地址在直接打开时(刷新或分享的链接)也应提供相同的内容。 关于内部链接的通用逻辑,请参阅我们的内部链接策略文章。

状态码、noindex 与 canonical

这是 JavaScript 应用中最容易被忽视的问题:

  • 错误页面:在 SPA 中,不存在的地址可能显示“页面未找到”的文字,却返回 HTTP 200。这就是 soft 404。请让服务器返回真正的 404,或在错误视图中添加 noindex。详情请参阅我们的404 错误与 SEO文章。
  • Noindex 与 JavaScript:如果原始 HTML 中带有 noindex,谷歌可能会跳过渲染该页面;在这种情况下,试图用 JavaScript 移除 noindex 是无效的。希望被索引的页面,其首次 HTML 中不应包含 noindex。
  • Canonical:尽可能在首次 HTML 中写入。虽然可以通过 JavaScript 添加,但两个相互矛盾的 canonical(HTML 中一个,脚本中另一个)会让谷歌感到困惑。关于 canonical 的逻辑,请参阅我们的 canonical 指南。
  • 重定向:优先选择服务器端的 HTTP 重定向,而不是 JavaScript 重定向;两者的区别已在我们的301 与 302 文章中说明。

测试谷歌看到的内容

  1. 比较源代码:在浏览器中对比“查看页面源代码”(原始 HTML)与开发者工具中的 Elements(渲染后的 DOM)。如果正文只出现在后者中,说明内容依赖 JS。
  2. URL 检查:在 Search Console 中检查该地址,点击“测试实际网址”,并查看 Google 渲染后的 HTML 和屏幕截图。
  3. 禁用 JavaScript 测试:在浏览器中关闭 JavaScript 后打开页面。如果什么都没有显示,那么机器人在第一阶段也只会看到空白内容。
  4. 无法加载的资源:在 URL 检查中查看是否有被屏蔽或加载失败的脚本或 API 调用。
  5. 索引检查:用引号将页面中的一句话与 site:您的域名.com 一起搜索,以确认内容是否已被编入索引。

如果页面最终没有被索引,可以将 Search Console 的状态与我们的索引问题指南对照,以缩小原因范围。

上线前检查清单

如果您与开发团队合作,请在每次重要发布前,对以下各项逐一标记“是 / 否”:

  • 页面的标题、正文和主图是否都存在于首次 HTML 响应中?
  • 每个页面是否都有唯一的 title、description,以及指向自身地址的 canonical 标签?
  • 菜单和分页链接是否为真正的 <a href>?
  • 不存在的地址是否返回真正的 404?
  • 重要的 JS 和 CSS 文件是否未被 robots.txt 屏蔽?
  • 即使关闭 JavaScript,页面是否至少能显示主要内容?
  • 当脚本出错或 API 变慢时,页面是否会变成空白,还是会显示合理的备用内容?
  • 新增视图(route)时,是否会自动加入站点地图?

这份清单在新网站上有用,在现有网站的设计或基础架构改版时同样有用。如果 SEO 负责人在开发初期就与团队分享这份清单,修正成本会大大降低; 因为一旦架构决定下来,更改渲染方式是代价最高的事情。

性能与 JavaScript

笨重的 JavaScript 包不仅会给机器人带来负担,也会给用户带来负担。大型脚本可能会恶化交互延迟(INP)和加载时间(LCP)。 代码分割(code splitting)、清理未使用的代码、限制第三方脚本以及延迟加载非关键脚本,都是基本步骤。关于指标,请参阅我们的 Core Web Vitals 指南;关于整体速度优化,请参阅 页面速度提升方法。谷歌的官方说明可参阅 JavaScript SEO 基础文档。

常见问题

谷歌是否完全理解 JavaScript?

在很大程度上它可以执行,但渲染意味着额外的排队和延迟。在首次 HTML 中提供关键内容是最安全的方式。

React 或 Vue 对 SEO 不利吗?

不利。问题不在框架,而在内容的呈现方式。通过 SSR 或静态生成,这些框架同样可以做好 SEO。

我应该使用动态渲染吗?

谷歌不推荐将其作为长期解决方案。对于新项目,SSR 或 SSG 是更合适的选择。

懒加载会损害 SEO 吗?

如果实施正确就不会。请使用浏览器原生的加载方式,并确保内容的触发不需要用户交互;因为 Googlebot 不会点击或滚动。

总结

JavaScript SEO 的核心是:您希望谷歌看到的一切,都应该在机器人请求页面时即可访问。在首次 HTML 中提供内容,使用真实的链接和真实的地址,返回正确的状态码, 不要屏蔽重要的脚本,并定期通过 URL 检查验证渲染后的页面。把这些习惯纳入您的技术 SEO 检查清单,大多数问题都可以在上线前被发现。

您的关键词缺少点击吗?

HitBot 会生成真实会话:在您的目标关键词下搜索、找到您的网站并点击。结果会以展示和点击的形式累积在 Search Console 中。

其他文章