👤 关于本项目
这是一个 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(客户端渲染),根据每个页面需求灵活选择。