Astro 使用与落地页(Landing Page)设计

Astro 是一个内容优先的 Web 框架:默认输出静态 HTML、默认零 JavaScript,只在真正需要交互的局部“挂载”组件。这个特性让它非常适合做营销页、产品落地页、文档站、博客——它们最需要的是“首屏快 + SEO 好 + 好维护”,而不是一个全量 SPA。

  • 默认零 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、集成、构建选项

文件顶部用三条短横线包起来的区域是 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。
  • 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 落地页

## 为什么用 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 未闭合
- 静态模式误用服务端能力

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • astro.txt
  • 最后更改: 2026/10/14 11:45
  • 由 张叶安