Astro SEO 审计：用 Python 检查你的 Astro 站点

Astro 自带了不少 SEO 需要的东西：默认零 JS、渲染快、内置 sitemap。但这不意味着你的 Astro 站点就自动优化好了。缺 canonical 标签、meta description 太单薄、内部链接失效、alt 文本缺失——这些问题会悄无声息地叠加。

大多数 Astro SEO 教程会给你一份 checklist，让你手动检查每个页面。这对只有 5 个页面的站还行。再大一点，你就得靠自动化了。

下面是用 Python 对 Astro 站点做完整 SEO 审计的方法——也是我们在每次上线前对每个 Astro 项目都会跑的审计。

为什么 Astro 站点有特定的 SEO 模式

Astro 的架构决定了它有一套独特的 SEO 画像：

静态 HTML 输出。 页面在构建时就渲染好了，Google 不需要执行 JavaScript 就能看到完整内容。相比 Next.js 或 Vue 应用，这是巨大的优势——但前提是你的构建里包含了正确的标签。

Content collections。 Astro 的 src/content/ 系统强制使用 schema，这对一致性很有好处。但如果你的 schema 没有包含 description 或自定义 canonical 这类 SEO 关键字段，那每个页面都会缺这些。

Island 架构。 大部分内容是静态的，但交互性的 island（React/Vue/Svelte 组件）如果在首屏水合，可能会引起布局偏移。我们见过不少 LCP 很完美、CLS 却很糟糕的 Astro 站点，罪魁祸首就是一个水合的导航栏。

astro:content 的 frontmatter = 你的 meta 标签。 不像 WordPress 有 SEO 插件自动处理，在 Astro 里你需要手动把 frontmatter 字段接到 layout 的 <meta> 标签上。漏掉这一步，description 就是空的。

审计：要查什么

1. Meta 标签和 Title 标签

每个页面都需要唯一的 <title> 和 <meta name="description">。在 Astro 里，这意味着你的 layout 组件必须接收这些 props 并渲染出来。

常见错误：在 layout 里设了一个默认 title，然后在具体页面上忘了覆盖。

# Run the audit
python3 -m zens_ink.site_audit https://your-astro-site.com \
  --checks meta

审计会标记出：

• 标题重复的页面（通常是 404 页或分页页面）
• 缺少 meta description 的页面（Astro 不会自动生成）
• Title 太长或太短，不适合 SERP 展示
• Description 和页面内容对不上的情况

2. Canonical URL

Astro 默认生成目录风格的 URL（带尾部斜杠的 /blog/my-post/）。如果你的 astro.config.mjs 设置了 trailingSlash: 'ignore'，canonical 行为就会不一致——有的页面带斜杠，有的不带。

python3 -m zens_ink.site_audit https://your-astro-site.com \
  --checks canonical

注意检查：

• 自引用 canonical 和实际 URL 对不上（通常是因为 config 里没设置 site）
• 完全缺失 canonical 标签（Astro 默认不会加——你需要在 layout 里写 <link rel="canonical" href={Astro.url} />）

小技巧： 在 astro.config.mjs 里设置 site。不设的话，Astro 在 sitemap 和 RSS feed 里生成的是相对 URL，Google 处理起来很吃力。

3. Sitemap 和 Robots.txt

Astro 的 @astrojs/sitemap 集成会自动生成 sitemap-index.xml。但有个坑：

• SSR 路由不会被包含。 如果你的页面设置了 prerender = false，它们不会出现在 sitemap 里。你需要为这些页面额外生成一个补充 sitemap。
• site 配置是必需的。 如果你没在 config 里设置 site: 'https://example.com'，sitemap 里的 URL 就是相对的——Google Search Console 会直接拒绝。

运行 sitemap 检查器：

python3 -m zens_ink.site_audit https://your-astro-site.com \
  --checks sitemap

它会验证：

• Sitemap 存在且是合法的 XML
• Sitemap 里的所有 URL 都返回 200
• 没有孤儿页面（存在但没进 sitemap 的页面）
• robots.txt 里有引用 sitemap

4. 结构化数据（JSON-LD）

Astro 不会自动添加结构化数据。你需要自己在 layout 或组件里手写 JSON-LD 块。这也是大多数 Astro 站点做得不够的地方——内容很好，但 schema 标记为零。

每个 Astro 站点至少应该有：

• 首页有 Organization 或 WebSite schema
• 博客文章有 Article schema
• 所有内页有 BreadcrumbList

审计会检查存在性和有效性：

python3 -m zens_ink.site_audit https://your-astro-site.com \
  --checks schema

想更深入了解结构化数据的实现，看我们的 Schema Markup for SEO 指南。

5. 内部链接

Astro 的 <a href="/blog/post/"> 链接对用户来说没问题，但你需要确认：

• 没有失效链接（可能是因为改了 slug 或删了页面）
• 所有内部链接的尾部斜杠一致（和你的 trailingSlash 配置匹配）
• 没有孤儿页面（站内没有任何地方链接到它们）

python3 -m zens_ink.site_audit https://your-astro-site.com \
  --checks links

内部链接是最被低估的排名因素。完整的策略看我们的 Internal Linking SEO 指南。

6. 图片 Alt 文本

Astro 的 <Image /> 组件（来自 @astrojs/image）不强制要求 alt 文本——但 Google 需要。审计会标记出每个没有 alt 属性的 <img>。

在 Astro 组件里，始终传入 alt 文本：

<Image src={post.data.cover} alt={post.data.title} width={1200} height={630} />

7. Core Web Vitals

Astro 站点通常在 LCP（没有阻塞渲染的 JS）和 CLS（静态布局）上得分不错。但要注意：

• 水合的 island 阻塞交互，产生 INP 问题
• 未优化的图片导致 LCP 回退（用 Astro 内置的图片优化功能）
• 第三方脚本造成的 TBT（分析工具、cookie 横幅——用 async 或 defer）

完整的 Core Web Vitals 分析，看我们的 Page Speed SEO 指南。

运行完整审计

与其每个区域单独检查，不如直接跑完整的流水线：

python3 -m zens_ink.site_audit https://your-astro-site.com \
  --output report.md

这会生成一份按优先级排序的报告，涵盖：

• Meta 标签（title、description、canonical）
• Sitemap 完整性
• 失效链接和重定向
• Schema 标记存在性
• 图片 alt 文本
• 移动端响应式信号
• robots.txt 分析

报告按严重程度标记问题：Critical（上线前必须修）、Warning（本周内修）、Info（锦上添花）。

我们常见的 Astro SEO 错误

审计了这么多 Astro 站点之后，我们总结出这些常见模式：

1. config 里没设置 site。 这会导致 sitemap、canonical 和 OG 标签全部出问题。修复：export default defineConfig({ site: 'https://yourdomain.com' })。

2. SSR 页面不在 sitemap 里。 Astro 的 sitemap 集成只包含预渲染的页面。如果你的 [slug].astro 页面设置了 prerender = false，需要生成补充 sitemap。

3. 尾部斜杠不一致。 如果 config 里是 trailingSlash: 'always'，但内部链接用的是裸路径（/blog/post 而不是 /blog/post/），每个链接都会触发 301 重定向。浪费爬取预算。

4. 缺少 OG 图片。 Astro 不会自动生成社交卡片。你需要在 meta 标签里加 og:image，指向一个真实的图片 URL。

5. content collections 导致 description 为空。 如果你的 schema 里是 description: z.string().optional() 而且你也没填，页面发布时就没有 meta description。要么把它设为必填，要么加一个 fallback。

总结

Astro 给了你一个快速、干净的基础。审计确保你在实现过程中没有留下 SEO 漏洞。每次部署前跑一遍，持续跟踪问题，你的 Astro 站点会在每一个技术 SEO 指标上超越那些更重的框架。

更广泛的技术 SEO 审计方法论（不限于 Astro），看我们的 Technical SEO Audit Without Paid Tools 指南。针对 Astro 混合渲染的爬取预算优化，看我们的 Crawl Budget 指南。

完整的审计工具是开源的，属于 ZensInk SEO toolkit。克隆下来，在你自己的 Astro 站点上跑一遍，然后修复它发现的问题。