👤 关于本项目

这是一个 Astro 框架的示范项目,旨在展示 Astro 最核心的功能和最佳实践。

🎯 示范内容

✅ 已包含

  • 🚀 基于文件的路由系统
  • 📄 Markdown 内容集合 + 动态路由
  • ⚛️ React 客户端岛屿组件
  • 🎨 Scoped CSS + 全局样式
  • 📱 响应式布局设计
  • 🏗️ 可复用布局系统
  • 🔄 动态路由 [slug]

🔜 可扩展

  • 🖼️ 图片优化集成
  • 🗺️ Sitemap 自动生成
  • 📡 RSS 订阅源
  • 🔍 全文搜索
  • 🎨 Tailwind CSS 集成
  • 📊 数据库对接
  • 🌐 国际化 i18n

📖 技术栈

Astro 5.x React 19 TypeScript Markdown CSS Custom Properties

🧠 核心概念

🏝️ 岛屿架构

Astro 默认输出零 JavaScript 的纯静态 HTML。只有标记了 client:* 指令的组件才会在客户端加载 JS, 就像静海中独立交互的「岛屿」。

⚡ 内容集合

Astro 的 content/ 目录提供类型安全的内容管理, 支持 Markdown、MDX 等格式,内置 Zod 验证。

🔀 混合渲染

同一项目中可以混合 SSG(静态生成)、SSR(服务端渲染)和 CSR(客户端渲染),根据每个页面需求灵活选择。