Astro 生产案例

import { defineConfig } from 'astro/config'; import tailwindcss from '@tailwindcss/vite'; import sitemap from '@astrojs/sitemap'; export default defineConfig({ site: 'https://aicode8.com', output: 'static', vite: { plugins: [tailwindcss()] }, integrations: [sitemap()], });

同一份配置，换运行时

[install]
exact = true
frozenLockfile = true

[run]
bun = true

verified bun 1.1.x

Core Failure Surface

复盘一个用 Astro SSG 承载百万级长尾词的真实架构，含构建拆分与边缘缓存策略。

Production Configuration

Verified against astro 5.x, @tailwindcss/vite 4.x. astro.config.mjs — static output + Tailwind v4 + sitemap

import { defineConfig } from 'astro/config';
import tailwindcss from '@tailwindcss/vite';
import sitemap from '@astrojs/sitemap';

export default defineConfig({
  site: 'https://aicode8.com',
  output: 'static',
  vite: { plugins: [tailwindcss()] },
  integrations: [sitemap()],
});

Troubleshooting Nodes

Astro 哪个版本开始稳定支持 @tailwindcss/vite 集成？

Astro 5 起官方推荐用 @tailwindcss/vite 插件替代旧 PostCSS 方案；升级前先锁定 astro 与 tailwind 主版本，避免 v3 配置被新插件忽略。

Astro 静态站部署到 Cloudflare Pages 后缓存如何失效？

每次 git 提交触发原子化重新构建，全量静态产物整体替换；HTML 用 must-revalidate、静态资源用 immutable 长缓存，无需手动戳 CDN。

Verification Gate

Every asset in this matrix must pass a full static build before it is eligible for manual review. Automated publishing is disabled by design.

常见问题与避坑

Astro 哪个版本开始稳定支持 @tailwindcss/vite 集成？