#Astro

两次更新做的是同一件事。v2.3.0 把散落的旧文章收进七部书系、写了三篇总纲；v2.4.0 给每篇文章加上 TL;DR、阅读路线、继续阅读和内容类型。文章一篇没多，但读完一篇之后你知道下一条路在哪。

118 篇文章之后，我不把它叫博客了。栏目、书系、双向链接、Changelog、构建链路——一个个人出版物的内容系统是怎么长出来的。

Astro Content Layer、Cloudflare Pages、GitHub Actions 定时构建、filterPublished 日期过滤——博客的完整技术链路拆解。

v1.9.5 是一次偏「工程化 + 体验打磨」的更新：深色模式支持系统跟随、此刻页新增 GitHub 风格发布热力图、站内搜索支持缩略图与 tag:/category: 筛选、集成 KaTeX 数学公式、新增建文与断链扫描脚本、接入 Lighthouse CI 自动审计，并补全了结构化数据与安全响应头。

给博客加上了「划词高亮 + 读书笔记」（数据只存本地），把站内搜索升级成 Pagefind（中文分词、模糊匹配、全文检索），还顺手修掉了几个藏了很久的 bug。

从旧版 content collections 迁移到 Astro 5 的 Content Layer API，构建速度提升 5 倍，内存少了一半。记录踩坑过程和实际改动。

从 Obsidian 到博客评论系统，拆解本地优先的核心组件：本地存储、后台同步、冲突解决，以及如何在不过度工程的前提下真正落地

从博客到数字花园：我是怎么用 seed/bud/bloom 重新组织的，这套系统怎么用代码实现，以及 v1.5.0 全站花园主题化改造。

我用 Astro Islands 的地方，以及踩过的坑。没有理论，只有我和几段代码。

很多人觉得读源码就是 clone 下来从头看。错了。读源码的正确方式是带着具体问题去翻特定文件。这篇讲我的四步源码阅读法。

从系统默认字体到 Google Fonts 到自托管，从随手引入到用脚本批量下载 woff2，字体方案这件事，我前后改了四版。

每个技术决策背后都有一个没说出口的理由。选 Astro 不是因为它最好，而是因为我受够了每半年换一次框架。选 Cloudflare Pages 不是因为它最快，而是因为免费。

深入 Astro 的岛屿架构：静态 HTML 为主体，交互组件为岛屿。

从实际迁移经验出发，深入 Astro 的两种渲染模式，分析适用场景、性能差异和架构选择。

从站名到导航菜单——云图札记的所有配置项、字段含义与定制方法。

从 Astro 博客的实际配置出发，讲解如何把配置分层管理，避免一个文件管一切。

深入 Astro Content Collections 的高级能力：自定义路由映射、分页策略、schema 联合校验、内容关系建立。

深入 Astro scoped CSS 的编译过程，解释为什么动态 DOM 无法匹配 scoped 样式。

从零实现 Astro 博客的中英双语支持：URL 路由策略、内容组织方式、导航切换、语言切换器。

Astro 博客的每个页面由多个组件拼成。学会看懂 .astro 文件，你就有了完全定制博客的能力。

零基础也能跟着做：从安装 Node.js 到 Astro 项目初始化、写第一篇文章、配置域名，最后一键部署到 Cloudflare Pages 的完整流程。