一个不会 Astro 的人，如何在 Mac 上借助 AI 搭建博客第一版

这次搭博客，是从一个很朴素的目标开始的：先有一个能继续写下去的中文个人知识站。

我并不会 Astro，也没有打算一开始就把事情做得很复杂。我的 Mac 使用 Apple 芯片，环境里原本的 Node.js 23 通过 nvm 切换到了 Node.js 24.22.2，作为这次建站的起点。

模板没有一次成功

一开始想直接使用 Astro 官方的 Blog 模板。但下载过程中两次遇到了 GitHub 504，模板没有顺利拉下来。

这不是一个需要反复硬碰硬的问题。后来改用 Astro 的 basic starter，项目便成功创建了。对刚开始的人来说，先让基础项目正常运行，比执着于某一个模板更重要。

先确认本地能跑起来

项目创建后，本地 Astro 预览能够正常打开。这一步虽然简单，却让我确认了两件事：Node.js 环境可用，Astro 项目本身也已经能启动。

在这个基础上，再借助 AI 协助检查项目文件、现有依赖和默认页面，后面的改造才有了清晰的边界。

从基础模板到中文博客第一版

这次没有增加新的依赖，也没有急着部署。Codex 将基础项目改造成了一个中文博客的第一版：

• 首页包含简短介绍、分类入口和最新文章区域；
• 有文章列表、文章详情、分类、关于和 404 页面；
• 文章使用 Astro Content Collections 和 Markdown 管理；
• 草稿不会出现在公开页面或站点地图中；
• 站点名称、简介和导航集中放在同一个配置文件里，之后可以继续调整。

现在这篇文章也放进了内容目录，成为这个站点的第一篇公开记录。

这次过程留下的提醒

搭建第一版不需要把所有功能一次完成。环境能用、项目能运行、内容能被写进站点，已经是一个可靠的起点。

过程中遇到模板下载失败，也不代表需要停下。换一个更简单的 starter，保留目标，继续往前推进就好。

最后运行 npm run build 成功，说明这版静态站点可以完成构建。它还没有上线，也谈不上什么效果；但从这里开始，后续可以把真实的 AI 实践、外贸工作、网站与自动化笔记慢慢写进去。