====== 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;

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