差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版
前一修订版
astro [2026/10/14 11:42] – 创建 张叶安astro [2026/10/14 11:45] (当前版本) – 为 astro 页面添加落地页设计思维导图 张叶安
行 1: 行 1:
-1+====== 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 / 任意静态托管即可。 
 + 
 +===== 二、快速开始 ===== 
 + 
 +<code bash> 
 +# 创建项目(官方脚手架,会引导你选模板与依赖) 
 +npm create astro@latest my-landing 
 + 
 +cd my-landing 
 +npm install 
 + 
 +npm run dev       # 开发服务器,默认 http://localhost:4321 
 +npm run build     # 产出静态站点到 dist/ 
 +npm run preview   # 本地预览构建结果 
 +</code> 
 + 
 +配置文件通常只写必要的几行: 
 + 
 +<code js> 
 +// astro.config.mjs 
 +import { defineConfig } from 'astro/config'; 
 +import sitemap from '@astrojs/sitemap'; 
 + 
 +export default defineConfig({ 
 +  site: 'https://example.com',   // 影响 canonical / sitemap,务必填对 
 +  integrations: [sitemap()], 
 +}); 
 +</code> 
 + 
 +===== 三、目录结构 ===== 
 + 
 +^ 路径 ^ 作用 ^ 
 +| ''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 代码),下面就是模板: 
 + 
 +<code> 
 +// 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> 
 +</code> 
 + 
 +其中 ''Astro.props'' 拿到外部传入的参数,花括号里可以写任意 JS 表达式。样式写在同一文件的样式块中,默认只作用于本组件: 
 + 
 +<code css> 
 +.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; 
 +} 
 +</code> 
 + 
 +在页面里引用它,并传入文案: 
 + 
 +<code> 
 +// 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> 
 +</code> 
 + 
 +**要点**:文案通过 props 传入,组件只管排版。这样同一个 Hero 可以复用到不同活动的落地页,只换数据。 
 + 
 +===== 五、岛屿:按需加水合 ===== 
 + 
 +只有需要状态和事件的组件才需要引入框架(React / Vue / Svelte / Solid / Preact),并加上客户端指令: 
 + 
 +<code> 
 +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 /> 
 +</code> 
 + 
 +^ 指令 ^ 何时水合 ^ 
 +| ''client:load'' | 页面加载后立即 | 
 +| ''client:idle'' | 主线程空闲时 | 
 +| ''client:visible'' | 元素进入视口时(**落地页最常用**) | 
 +| ''client:media'' | 匹配指定媒体查询时 | 
 +| ''client:only'' | 跳过服务端渲染,只在浏览器渲染 | 
 + 
 +落地页的经验法则:**能静态就静态**。表单校验、定价切换、评价轮播、聊天挂件各做成一个岛;导航、Hero、功能列表全部保持静态。 
 + 
 +===== 六、数据驱动的内容 ===== 
 + 
 +把反复出现的营销数据放进 ''src/data/'',页面里循环渲染: 
 + 
 +<code ts> 
 +// src/data/features.ts 
 +export const features = [ 
 +  { icon: '⚡', title: '极速首屏', desc: '默认零 JS,LCP 通常低于 1 秒。' }, 
 +  { icon: '🧩', title: '组件复用', desc: '一次写 Hero,多处换文案。' }, 
 +  { icon: '🔍', title: 'SEO 友好', desc: '静态 HTML + sitemap + 结构化数据。' }, 
 +]; 
 +</code> 
 + 
 +<code> 
 +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> 
 +</code> 
 + 
 +需要 Markdown / MDX 内容时(博客、案例页),用 Content Collections。Astro 5 的写法是在 ''src/content.config.ts'' 里定义 loader 与 schema: 
 + 
 +<code ts> 
 +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 }; 
 +</code> 
 + 
 +这样 frontmatter 字段写错会在构建时直接报错,而不是上线后才发现页面缺图。 
 + 
 +===== 七、样式与图片 ===== 
 + 
 +**样式**:组件里的样式块默认只作用于当前组件。品牌色、正文字色、容器宽度、圆角这类**设计令牌**建议集中放在全局 CSS 里(''src/styles/global.css''),在 Layout 中 import 一次: 
 + 
 +<code css> 
 +/* 全局设计令牌集中在这里:品牌色 / 正文字色 / 辅助文字色 / 容器最大宽 / 圆角 */ 
 +.container { max-width: 1120px; margin-inline: auto; padding-inline: 1.5rem; } 
 +.section { padding-block: 6rem; } 
 +</code> 
 + 
 +用 Tailwind 也可以。Tailwind v4 的推荐方式是走 Vite 插件: 
 + 
 +<code js> 
 +import { defineConfig } from 'astro/config'; 
 +import tailwindcss from '@tailwindcss/vite'; 
 + 
 +export default defineConfig({ 
 +  vite: { plugins: [tailwindcss()] }, 
 +}); 
 +</code> 
 + 
 +**图片**:放在 ''src/assets/'' 的图片用 ''astro:assets'' 处理,自动压缩、转格式、生成响应式尺寸: 
 + 
 +<code> 
 +import { Image } from 'astro:assets'; 
 +import screenshot from '../assets/app-screenshot.png'; 
 + 
 +<Image src={screenshot} alt="仪表盘界面截图" loading="eager" /> 
 +</code> 
 + 
 +===== 八、落地页的信息架构 ===== 
 + 
 +一个能被验证有效的落地页,结构基本是固定的。建议就按这个顺序拆组件: 
 + 
 +^ 区块 ^ 目的 ^ 组件 ^ 
 +| 导航 | 减少迷失,露出主 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 未闭合 
 +- 静态模式误用服务端能力 
 +``` 

该主题尚不存在

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

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