{f.title}
{f.desc}
# 创建项目(官方脚手架,会引导你选模板与依赖)
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;
{title}
{subtitle}
{ctaText}
其中 ''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';
**要点**:文案通过 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';
^ 指令 ^ 何时水合 ^
| ''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';
{features.map((f) => (
{f.title}
{f.desc}
))}
需要 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';
===== 八、落地页的信息架构 =====
一个能被验证有效的落地页,结构基本是固定的。建议就按这个顺序拆组件:
^ 区块 ^ 目的 ^ 组件 ^
| 导航 | 减少迷失,露出主 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 官方文档:[[https://docs.astro.build|docs.astro.build]]
* Astro 主题与模板:[[https://astro.build/themes|astro.build/themes]]
```mdk height=520 color=#4f46e5
# 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 未闭合
- 静态模式误用服务端能力
```