Astro 是一个内容优先的 Web 框架:默认输出静态 HTML、默认零 JavaScript,只在真正需要交互的局部“挂载”组件。这个特性让它非常适合做营销页、产品落地页、文档站、博客——它们最需要的是“首屏快 + SEO 好 + 好维护”,而不是一个全量 SPA。
.astro 文件语法接近 JSX,但编译后不留运行时代码。src/data 与 Content Collections 让文案、功能项、FAQ 可以数据驱动渲染。astro build 产出 dist/,扔到 Netlify / Vercel / Cloudflare Pages / GitHub Pages / 任意静态托管即可。# 创建项目(官方脚手架,会引导你选模板与依赖) npm create astro@latest my-landing cd my-landing npm install npm run dev # 开发服务器,默认 http://localhost:4321 npm run build # 产出静态站点到 dist/ npm run preview # 本地预览构建结果
配置文件通常只写必要的几行:
// astro.config.mjs
import { defineConfig } from 'astro/config';
import sitemap from '@astrojs/sitemap';
export default defineConfig({
site: 'https://example.com', // 影响 canonical / sitemap,务必填对
integrations: [sitemap()],
});
| 路径 | 作用 |
|---|---|
src/pages/ | 文件路由。index.astro 即首页,pricing.astro 即 /pricing |
src/layouts/ | 页面外壳(HTML 骨架、head、导航、页脚),用 slot 放内容 |
src/components/ | 可复用组件:Hero、FeatureGrid、Pricing、FAQ… |
src/content/ | Markdown / MDX 或 JSON 形式的结构化内容,配 schema 校验 |
src/assets/ | 需要被构建优化的图片(会被处理、生成多尺寸) |
public/ | 原样拷贝的静态文件:favicon、robots.txt、OG 图 |
astro.config.mjs | 站点 URL、集成、构建选项 |
文件顶部用三条短横线包起来的区域是 frontmatter(构建时运行的 JS/TS 代码),下面就是模板:
// src/components/Hero.astro
const { title, subtitle, ctaText = '开始使用', ctaHref = '/signup' } = Astro.props;
<section class="hero">
<h1>{title}</h1>
<p>{subtitle}</p>
<a class="btn" href={ctaHref}>{ctaText}</a>
</section>
其中 Astro.props 拿到外部传入的参数,花括号里可以写任意 JS 表达式。样式写在同一文件的样式块中,默认只作用于本组件:
.hero { padding: 6rem 1.5rem; text-align: center; } .hero h1 { font-size: clamp(2rem, 5vw, 3.5rem); line-height: 1.1; margin: 0 0 1rem; } .btn { display: inline-block; padding: .75rem 1.5rem; border-radius: 999px; background: #4f46e5; color: #fff; text-decoration: none; }
在页面里引用它,并传入文案:
// src/pages/index.astro
import Layout from '../layouts/Layout.astro';
import Hero from '../components/Hero.astro';
<Layout title="产品名 — 一句话价值主张" description="为谁解决什么问题">
<Hero
title="让团队周报 5 分钟写完"
subtitle="自动收集进度、自动排版,支持导出与分享。"
ctaText="免费试用"
ctaHref="/signup"
/>
</Layout>
要点:文案通过 props 传入,组件只管排版。这样同一个 Hero 可以复用到不同活动的落地页,只换数据。
只有需要状态和事件的组件才需要引入框架(React / Vue / Svelte / Solid / Preact),并加上客户端指令:
import PricingToggle from '../components/PricingToggle.jsx'; import LeadForm from '../components/LeadForm.jsx'; import ChatWidget from '../components/ChatWidget.jsx'; <!-- 首屏可见且需要立刻响应 --> <PricingToggle client:load /> <!-- 滚到可视区域才加载:省首屏开销,落地页最常用 --> <LeadForm client:visible /> <!-- 主线程空闲时加载 --> <ChatWidget client:idle />
| 指令 | 何时水合 |
|---|---|
client:load | 页面加载后立即 |
client:idle | 主线程空闲时 |
client:visible | 元素进入视口时(落地页最常用) |
client:media | 匹配指定媒体查询时 |
client:only | 跳过服务端渲染,只在浏览器渲染 |
落地页的经验法则:能静态就静态。表单校验、定价切换、评价轮播、聊天挂件各做成一个岛;导航、Hero、功能列表全部保持静态。
把反复出现的营销数据放进 src/data/,页面里循环渲染:
// src/data/features.ts
export const features = [
{ icon: '⚡', title: '极速首屏', desc: '默认零 JS,LCP 通常低于 1 秒。' },
{ icon: '🧩', title: '组件复用', desc: '一次写 Hero,多处换文案。' },
{ icon: '🔍', title: 'SEO 友好', desc: '静态 HTML + sitemap + 结构化数据。' },
];
import { features } from '../data/features';
<section class="grid">
{features.map((f) => (
<article class="card">
<div class="icon" aria-hidden="true">{f.icon}</div>
<h3>{f.title}</h3>
<p>{f.desc}</p>
</article>
))}
</section>
需要 Markdown / MDX 内容时(博客、案例页),用 Content Collections。Astro 5 的写法是在 src/content.config.ts 里定义 loader 与 schema:
import { defineCollection, z } from 'astro:content';
import { glob } from 'astro/loaders';
const cases = defineCollection({
loader: glob({ pattern: '*.md', base: './src/content/cases' }),
schema: z.object({
title: z.string(),
customer: z.string(),
logo: z.string().optional(),
date: z.coerce.date(),
}),
});
export const collections = { cases };
这样 frontmatter 字段写错会在构建时直接报错,而不是上线后才发现页面缺图。
样式:组件里的样式块默认只作用于当前组件。品牌色、正文字色、容器宽度、圆角这类设计令牌建议集中放在全局 CSS 里(src/styles/global.css),在 Layout 中 import 一次:
/* 全局设计令牌集中在这里:品牌色 / 正文字色 / 辅助文字色 / 容器最大宽 / 圆角 */ .container { max-width: 1120px; margin-inline: auto; padding-inline: 1.5rem; } .section { padding-block: 6rem; }
用 Tailwind 也可以。Tailwind v4 的推荐方式是走 Vite 插件:
import { defineConfig } from 'astro/config';
import tailwindcss from '@tailwindcss/vite';
export default defineConfig({
vite: { plugins: [tailwindcss()] },
});
图片:放在 src/assets/ 的图片用 astro:assets 处理,自动压缩、转格式、生成响应式尺寸:
import { Image } from 'astro:assets';
import screenshot from '../assets/app-screenshot.png';
<Image src={screenshot} alt="仪表盘界面截图" loading="eager" />
一个能被验证有效的落地页,结构基本是固定的。建议就按这个顺序拆组件:
| 区块 | 目的 | 组件 |
|---|---|---|
| 导航 | 减少迷失,露出主 CTA | Nav.astro |
| Hero | 3 秒讲清“谁 / 做什么 / 值多少” | Hero.astro |
| 社会证明 | 客户 logo、数据、媒体背书 | LogoWall.astro |
| 问题—方案 | 制造共鸣,指出旧做法为什么不行 | PainSolution.astro |
| 功能卖点 | 3—6 个,配截图或动图 | FeatureGrid.astro |
| 演示 | 真实界面或视频,降低想象成本 | Demo.astro |
| 用户评价 | 信任转移 | Testimonials.astro |
| 定价 | 给出选择,标出推荐项 | Pricing.astro |
| FAQ | 打消最后疑虑 | FAQ.astro |
| 结尾 CTA | 再要一次转化 | CtaBanner.astro |
| 页脚 | 合规、导航、联系方式 | Footer.astro |
clamp() 和自适应网格放大,比反过来改容易得多。alt、装饰性图标加 aria-hidden。Layout.astro 里放全站公共 head:charset、viewport、title、meta description、canonical、OG / Twitter 卡片。astro.config.mjs 的 site 一定要填,否则 sitemap 与 canonical 会指向错误域名。loading=“eager”,并给出宽高(或用 Image 组件)以避免布局抖动。display=swap 并预加载关键字体,或直接用系统字体栈。defer,或用 client:idle 的岛延后加载。astro-og-canvas 之类集成按页面生成。src/assets/。prerender = false。# Astro 落地页 ## 为什么用 Astro ### 默认零 JS ### 岛屿架构,按需水合 ### 文件路由 + 组件化 ### 静态产物,随处部署 ## 项目骨架 - src/pages 文件路由 - src/layouts 页面外壳 - src/components 区块组件 - src/data 与 content 数据驱动 - src/assets 待优化图片 - public 原样拷贝 - astro.config.mjs 站点与集成 ## 岛屿策略 - 能静态就静态 - client:load 立刻交互 - client:visible 进视口再加载 - client:idle 空闲加载 - 只有表单/切换/轮播才做岛 ## 落地页结构 ### Hero 价值主张 + 主 CTA ### 社会证明 logos 与数据 ### 问题到方案 ### 功能卖点 3 到 6 个 ### 演示与截图 ### 用户评价 ### 定价与推荐项 ### FAQ ### 结尾 CTA 与页脚 ## 设计要点 - 一页一个转化目标 - 标题写为谁解决什么 - 语义层级 H1 到 H3 - 留白与容器宽度 - CTA 重复三次 - 用数字替代形容词 - 移动优先 ## 性能与 SEO - site 配置与 canonical - sitemap 集成 - 首屏图片 eager - 字体 swap 与预加载 - 看 LCP CLS INP ## 常见坑 - 内联事件不生效 - 整页塞进一个框架组件 - 图片放 public 不优化 - frontmatter 未闭合 - 静态模式误用服务端能力