开场白:想写点自己的东西
很久以前我就想拥有一个属于自己的博客网站,一个可以自由书写、无拘无束的空间。写点技术心得,偶尔吐槽一下生活的琐碎,甚至发表一些“思考人生”的胡言乱语。这个想法断断续续在脑子里盘旋了很多年,但一直没有真正开始。直到最近,我终于下定决心要把它搭建起来。
这篇文章就是一篇记录,从最初的动机,到最终上线,中间踩过的坑、用过的工具、遇到的困难……统统记下来,算是送给自己的一份“通关文书”,也希望能帮到后来者。
选博客框架:静态站点生成器比 WordPress 香
最开始我也曾考虑过 WordPress。毕竟它是博客界的“老大哥”,上手容易,功能全面,主题丰富。但是试用了一下之后,我觉得它有点重、慢、不够酷。特别是像我这种喜欢简单、极简风、写 Markdown 的人,WordPress 有点“不搭调”。
后来我把目标转向了“静态博客框架”,比如:
- Jekyll(GitHub Pages 的亲儿子)
- Hugo(速度快,文档全)
- Hexo(中文资料多)
- Astro(新一代构建工具)
最终我选择了 Astro 框架下的一个主题 —— AstroPaper。原因很简单:
- 它长得好看!(优雅排版 + 极简风格)
- 自带文章目录、标签、响应式适配
- 用 Markdown 写文章,干净利索
- 支持部署到 Netlify、Vercel,非常友好
遇见 AstroPaper
AstroPaper 是一款基于 Astro 的博客模板,由 @satnaing 开发维护。它的 GitHub 地址是:
👉 https://github.com/satnaing/astro-paper
它支持 Markdown 写作,支持标签系统,带 SEO 优化,还支持部署到 Netlify、Vercel 这些主流平台,几乎就是我心目中“博客理想型”的样子。
一键部署,真香!
我通过 Netlify 的一键部署链接启动了博客:
👉 https://app.netlify.com/start/deploy?repository=https://github.com/satnaing/astro-paper
点开后,它会自动:
- Fork 一份博客模板代码到我的 GitHub
- 创建一个 Netlify 网站项目
- 自动构建、自动上线
整套流程完全不需要我写一行代码,只要登录 GitHub、授权、点几下按钮,几分钟后,我的博客就活生生地出现在了互联网上!
这一点让我非常震撼。以前总以为搭建博客很麻烦,其实现在工具链非常成熟,一切自动化,只要你愿意动手,博客根本不是问题。
写第一篇文章,也踩了点坑
AstroPaper 使用 Markdown 文件写作,每篇文章就是一个 .md 文件,放在仓库的 src/data/blog/ 目录下。格式长这样:
---
title: "文章标题"
description: "副标题简介"
pubDatetime: 2025-06-27T12:00:00Z
author: "da fa"
tags: ["分类1", "分类2"]
---
这里是正文内容。支持 Markdown 排版、代码高亮等等。
看起来很简单,但我第一次写文章时漏了 Markdown 的代码块结尾(忘了加 ```),结果部署失败。Netlify 报错说构建失败,差点以为模板有 bug,结果只是我写错了格式 😂。
但也正因为这个小插曲,我学会了查看 Netlify 的构建日志、定位错误,算是意外收获。
博客上线后我做了哪些个性化修改?
为了让它更符合我的个人风格,我做了以下自定义:
✅ 修改了博客标题、描述、副标题(在 src/config.ts 中)
✅ 修改作者头像和简介
✅ 把默认英文标题改成中文,适合国内读者
✅ 添加了第一篇文章,验证部署无误
接下来我可能还会:
集成评论系统(如 Giscus、Waline)
加入搜索功能(Pagefind)
换一个更简洁的字体
给博客绑定自定义域名
这些都可以慢慢来,不急。
过程中的收获
这次搭博客,我不光学会了使用 AstroPaper 主题,更重要的是:
明白了静态博客背后的原理(构建 → 发布 → 静态托管)
熟悉了 GitHub + Netlify 的部署流程
了解了 Markdown 的写作规范和 SEO 优化的基础
对前端项目的文件结构、配置方式也多了一些认知
有时候你不是真的要“搭博客”,你是想找一个机会,让自己动手,把“折腾”的乐趣找回来。博客本身只是载体,写作和表达才是目的。
最后说点感悟
写博客很像种树。
你起初只是挖了一个坑,放进一粒种子。可能刚开始没有人知道你种了什么,也不觉得这是什么事。但只要你愿意持续浇水、修剪、晒太阳,它就会慢慢长大,甚至某一天开出一朵只有你自己才能欣赏的花。
所以,如果你也曾经想过拥有一个属于自己的博客,现在就去做吧!不用等工具最完美,不用等内容最丰富,不用等你“准备好”。一边搭建,一边写,就是最好的状态。
感谢一路上帮助我的 ChatGPT,真的堪比随身博客助手 💻
如果你正在读这篇文章,欢迎留言交流、互加友链,让我们一起把写作的火种传下去 🌱
🔗 你现在看到的这个博客,就是我亲手搭建的成果
🌍 地址是:https://startling-sunflower-abba36.netlify.app/(暂时是默认域名)
敬请期待我的下一篇文章 😊