最后更新于

如何用 Astro 搭建个人博客


本篇文章记录了搭建这个博客的过程,也算是一篇小型教程。

为什么选择 Astro

  • 静态输出:构建后只有纯 HTML/CSS/JS,速度快、部署简单、不需要数据库
  • 内容集合:用 Markdown/MDX 写作,配合 schema 校验 frontmatter
  • 零 JS 默认:页面默认不加载任何 JavaScript,性能优秀
  • 生态完善:RSS、Sitemap、MDX 等官方集成开箱即用

搭建步骤

1. 初始化项目

npm create astro@latest blog -- --template blog --install

2. 配置站点信息

编辑 astro.config.mjs,设置 site 字段为最终访问地址:

export default defineConfig({
  site: 'http://your-domain.com',
  integrations: [mdx(), sitemap()],
});

3. 修改站点标题

src/consts.ts 中定义全局数据:

export const SITE_TITLE = '我的博客';
export const SITE_DESCRIPTION = '记录技术、生活与思考的个人博客';

4. 写作

src/content/blog/ 下新建 .md 文件,带上前置元数据:

---
title: '文章标题'
description: '文章简介'
pubDate: '2026-08-28'
---

这里是正文内容,支持 Markdown 语法。

5. 构建与部署

npm run build   # 输出到 dist/

然后用任意静态服务器托管 dist/ 目录即可。

小结

整个流程非常轻量,从初始化到上线只需要几分钟。后续可以继续扩展标签、评论、搜索等功能。