今天，我把 Astro 官方博客模板改造成了自己的中文技术博客。

这次过程并不是一路顺利：项目创建完成后，依赖安装提示超时，终端里也暂时找不到 node 和 npm。好消息是，项目文件和依赖目录其实都已经存在。确认环境后，网站顺利完成了构建。

我做了哪些事情

1. 确认项目使用的是 Astro 官方 Blog 模板。
2. 检查 package.json、页面目录和内容集合配置。
3. 把站点标题、导航、日期和说明全部中文化。
4. 重新设计深色科技风格的首页、文章列表和文章详情页。
5. 用 Markdown 替换原有的英文示例文章。

Astro 项目最重要的几个目录

src/
├── components/   # 可复用的页面组件
├── content/blog/ # Markdown 与 MDX 文章
├── layouts/      # 文章等页面的公共布局
├── pages/        # 根据文件路径生成网址
└── styles/       # 全站样式

理解这五个目录后，修改博客就不再像面对一个黑盒子。

下一篇文章怎么写

在 src/content/blog/ 新建一个 .md 文件，顶部填写标题、描述和日期，然后在下方使用 Markdown 写正文：

---
title: '文章标题'
description: '一句话介绍文章'
pubDate: '2026-08-10'
---

这里开始写正文。

保存后，Astro 会把文章加入内容集合，并自动生成文章页面。博客首页和文章归档也会读取到它。

建站不是一次性任务，而是一套可以不断重复的写作流程。