Astro 使用与落地页(Landing Page)设计
Astro 是一个内容优先的 Web 框架:默认输出静态 HTML、默认零 JavaScript,只在真正需要交互的局部“挂载”组件。这个特性让它非常适合做营销页、产品落地页、文档站、博客——它们最需要的是“首屏快 + SEO 好 + 好维护”,而不是一个全量 SPA。
一、为什么落地页适合用 Astro
- 默认零 JS:页面就是 HTML + CSS,LCP 快、CLS 小,移动端体验直接受益。
- 岛屿架构(Islands):整页静态,只有轮播、表单、定价切换这类部件按需加载 JS。
- 写 HTML 就是写组件:
.astro文件语法接近 JSX,但编译后不留运行时代码。 - 样式自动隔离:组件里的样式块默认 scoped,不用起类名前缀也不会串样式。
- 内容与数据分离:
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、集成、构建选项 |
四、.astro 组件基础
文件顶部用三条短横线包起来的区域是 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 |
九、设计要点(比框架更重要)
- 一个页面一个目标。落地页只服务一个转化动作(注册 / 试用 / 预约 / 下载),其他链接都算干扰。
- 首屏讲价值,不讲功能。标题公式:为【目标用户】解决【痛点】,无需【旧做法的代价】。副标题补一句机制或证据。
- 标题层级只有 3 级。H1 一个,区块用 H2,卡片标题用 H3。用语义层级表达结构,不只是用字号。
- 留白是最便宜的高级感。区块上下间距 6rem 左右,容器最大宽 1100—1200px,正文行宽 60—75 字符。
- CTA 全页重复 3 次以上:Hero、中部、结尾。同一个动作、同一套文案,颜色全程一致。
- 用具体数字代替形容词。“快”改成“首屏 0.8s”;“很多人用”改成“12,000 支团队在用”。
- 移动优先。先做 375px 宽度的排版,再用
clamp()和自适应网格放大,比反过来改容易得多。 - 可访问性就是可用性:对比度不低于 4.5:1、焦点样式可见、图片都有
alt、装饰性图标加aria-hidden。
十、性能与 SEO 清单
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的岛延后加载。 - 上线前跑一次 Lighthouse / PageSpeed,重点看 LCP、CLS、INP 三项。
- 需要 OG 图时,可以手写静态图,或用
astro-og-canvas之类集成按页面生成。
十一、常见坑
- 在 .astro 里直接写内联事件:没有框架运行时,内联事件属性不会生效,要么加原生 script 块,要么把它做成岛。
- 把整页做成一个 React 组件:等于放弃 Astro 的优势,退回 SPA 的体积。
- 图片全塞 public/:那样不会被优化,优先放
src/assets/。 - frontmatter 区域没闭合:文件会直接构建失败。
- 在静态输出下用服务端能力:需要请求期渲染时才引入 adapter,并给页面显式声明
prerender = false。
十二、参考
- Astro 官方文档:docs.astro.build
- Astro 主题与模板:astro.build/themes
# 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 未闭合 - 静态模式误用服务端能力