目录

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

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

一、为什么落地页适合用 Astro

二、快速开始

# 创建项目(官方脚手架,会引导你选模板与依赖)
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

九、设计要点(比框架更重要)

十、性能与 SEO 清单

十一、常见坑

十二、参考

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