Astro adapter 与 SSR/SSG 模式不匹配 —— 排查与修复
Astro 部署失败或页面白屏，多半是 adapter 跟 output 模式对不上，或某个路由的 prerender 标记悄悄推翻了全局模式。本文给出诊断与修复（Astro 5/6，2026 年 6 月）。
#Astro
带有该标签的文章
Astro 图片优化 2026：AVIF / layout / priority
2026 年的 Astro 图片管线最佳实践：AVIF 优先的 Picture、已转正的响应式 layout、LCP 图的 priority 快捷写法，以及大多数教程还没讲的 Astro 6.1 编码器配置。
Astro 增量内容更新：不用全量重建
3000 页的 Astro 站点，改一篇文章不重建整站：Content Layer 缓存、按需渲染路由、hash 卡 CI、按文件 CDN 刷新。2026 年 6 月实测的工作流。
怎么用 AI 审计 Astro 内容站（不用逐文件读）
一套可复用的 Astro 5/6 内容站 AI 审计：抓重复 slug、缺翻译、死内链、draft 泄漏，一个脚本接进 prebuild 就能挡住漂移。
Astro 适合做什么网站
Astro 6 决策指南（2026 年 6 月）：什么项目形态适合 Astro，什么时候该换 Next.js 或 Hugo，以及动手前用一天 spike 验证清楚。
Astro 6 静态站怎么做分类与标签页
用 Astro 6 的 Content Layer（glob + file 加载器）做分类与标签页：可扩展、能排名、还能绕开薄页陷阱的实战做法。
Astro Content Collections 入门：半小时上手（Astro 6）
面向 Astro 6 的 Content Collections 上手指南：glob() loader、content.config.ts、Zod schema、render(entry)，让上千篇规模的站点依然好维护。
Astro 部署到 Firebase Hosting（2026）
把静态 Astro 站点正确部署到 Firebase Hosting：firebase.json 配置、缓存头、干净 URL，以及那个会让你 404 失效的 SPA rewrite 陷阱。
Astro SEO 基础：title、meta、canonical、hreflang
Astro 站点的最低必备 SEO：每一页都要有的 head 标签、真正影响展示的像素上限，以及在 500+ 篇规模下仍成立的写法。
Astro sitemap 配置：hreflang、排除、lastmod
用 @astrojs/sitemap 在 Astro 里生成、校验、提交 sitemap.xml——hreflang 配对、filter 排除、lastmod，以及 Google 实际怎么用它（2026 年 6 月）。
内容站怎么选：Astro 还是 Next.js（2026 年 6 月）
Astro 6 对比 Next.js 16：真实版本信息、托管成本、决策清单，以及没人提醒你的迁移成本。
Markdown / MDX 内容站搭建
在 Astro 6 上搭一个能从 50 篇撑到 1000+ 篇都不重构的 Markdown / MDX 内容站，附 Content Layer schema、组件 map、内链检查和 brace 坑。
Vercel 部署 Astro：10 分钟上线（2026）
把 Astro 站部到 Vercel——附 Astro 5 的 astro.config.mjs、Node 22 锁版本、vercel.json 缓存头、CLI 命令、DNS + SSL 验证，一条龙不绕路。
Astro 部署后页面 404：3 个原因 + 修复路径
dev 正常、线上 404——多半是 build.format / trailingSlash / output 三者和宿主不对齐。给一条可照抄的修复路径。
用 Claude Code 搭内容站（2026 实战流程）
一套实测过的 2026 流程：用 Claude Code 搭双语 Astro 内容站——精确的 CLAUDE.md 脚手架、plan 模式、部署成本算账，以及 Agent 最容易翻车的地方。