程序员搭建个人博客的真实生命周期:搭站 3 天,折腾主题 3 周,写第一篇文章 3 个月。
前言:每个程序员都有一个博客梦
每个程序员的人生中,大概都会经历这样一个循环:
- 看到别人的博客很酷 → 2. 决定自己也要搞一个 → 3. 花几天时间搭建 → 4. 折腾主题和插件 → 5. 写一篇"Hello World" → 6. 再也没有然后了
我也不例外。这已经是我第四次搭建个人博客了。前三次的结局分别是:
- 第一次:用 WordPress,装完发现服务器要钱,卒。
- 第二次:用 Hexo + GitHub Pages,部署成功后兴奋了三天,然后忘了密码。
- 第三次:用 VuePress,主题改到一半,Vue 4 出来了,卒。
这一次,我发誓要把它做到底。以下是我的真实经历,希望能给同样在折腾路上的你一点参考(或者一点快乐)。
一、选型:技术栈的选择困难症
作为一名程序员,选技术栈的纠结程度不亚于女生选口红色号。
我列了一个表格,对比了各种方案:
| 方案 | 优点 | 缺点 | 适合人群 |
|---|---|---|---|
| WordPress | 生态强大 | 需要服务器、PHP、插件收费 | 不想写代码的人 |
| Hexo | 静态、免费、快 | 主题改起来要命 | 喜欢折腾的人 |
| Hugo | 构建超快 | Go 模板语法反人类 | 追求性能的人 |
| Next.js | 全能、现代 | 配置复杂,容易过度工程 | 前端工程师 |
| Astro | 新潮、内容优先 | 生态还在成长 | 追新的人 |
最后我选了 Astro + Markdown + Vercel。
为什么?因为 Astro 的官方文档第一句话就是:"Astro 是为内容驱动的网站设计的。"
翻译成人话就是:你不用写一堆 JS,专心写文章就行。
这简直是为我这种"想写博客但懒得写代码"的人量身定做的。
二、搭建:3 天,其中 2 天在配环境
Day 1:初始化项目
npm create astro@latest my-blog
cd my-blog
npm install
npm run dev
浏览器打开 localhost:8080,看到默认页面。这一刻是兴奋的。
Day 2:配置主题和样式
我选了一个叫 Astro Paper 的开源主题,clone 下来,改配置,调颜色,换字体。
然后我发现:
- 深色模式切换按钮位置不对
- 代码块高亮颜色太丑
- 移动端导航栏会重叠
- RSS 订阅链接 404
这一天,我写了 0 行博客内容,改了 200 行 CSS。
Day 3:部署到 Vercel
git init
git add .
git commit -m "init blog"
git remote add origin git@github.com:xxx/blog.git
git push -u origin main
然后在 Vercel 上点了几下,绑定域名,配置 DNS。
当 https://blog.xxx.com 显示出我的博客时,我激动得差点把咖啡洒在键盘上。
然后我打开博客,发现:
- 首页显示的是默认示例文章
- 关于页面还是模板作者的自我介绍
- 社交链接指向的是别人的 GitHub
行吧,至少它跑起来了。
三、内容:写第一篇文章的艰难历程
搭好博客后,我告诉自己:"明天就写第一篇文章。"
结果这个"明天",拖了 3 个月。
为什么?因为每次打开编辑器,我都会陷入以下思考:
- 写什么主题?太简单的显得没水平,太难的怕写错。
- 标题怎么取?要吸引人又不能太标题党。
- 代码示例用 Python 还是 JavaScript?
- 配图去哪找?版权怎么办?
- 写完没人看怎么办?
最后我发现,阻止我写文章的,不是技术问题,是心理问题。
直到有一天,我看到一句话:
"你不需要写出完美的文章,你只需要写出第一篇文章。"
于是我打开 src/content/posts/,新建了一个 hello-world.md,写下了:
---
title: "Hello World"
date: 2024-01-01
---
这是我的第一篇文章。
我知道它很烂,但至少它存在了。
然后我点了发布。
那一刻,我感觉自己终于完成了这个循环。
四、后续:那些我踩过的坑
1. 图片放哪里?
Astro 推荐把图片放在 public/ 或 src/assets/。我一开始全放 public/,结果图片越来越多,项目越来越大。
后来我学乖了:文章配图放 src/assets/,用相对路径引用,Astro 会自动优化。
2. 代码块高亮
Astro 内置了 Shiki,支持各种主题。我想用 One Dark Pro,配置如下:
js
// astro.config.mjs
import { defineConfig } from 'astro/config';
export default defineConfig({
markdown: {
shikiConfig: {
theme: 'one-dark-pro',
wrap: true,
},
},
});
然后我发现,代码块里的中文注释显示成了方框。
原因:Shiki 默认字体不含中文。解决办法:在 CSS 里指定中文字体。
css
pre, code {
font-family: 'JetBrains Mono', 'Noto Sans SC', monospace;
}
3. SEO 和 RSS
Astro 有官方的 @astrojs/rss 和 @astrojs/sitemap 插件,配置一下就能自动生成。
但记得改 site 配置,否则 RSS 里的链接全是 localhost。
4. 评论系统
我试了 Giscus、Waline、Twikoo,最后选了 Giscus。
为什么?因为它基于 GitHub Discussions,免费、无后端、不折腾。
配置方法:去 giscus.app 填仓库信息,拿到一段 script,粘贴到文章底部组件里。
然后我发现,我的 GitHub 仓库是私有的,Giscus 读不到 Discussions。
改成公开仓库,搞定。
五、心得:博客的意义是什么?
搭完博客后,我认真思考了一个问题:2024 年了,为什么还要写博客?
现在有公众号、知乎、掘金、Medium,为什么还要自己搭一个?
我的答案是:
- 完全掌控:不被平台算法绑架,不被删帖,不被限流。
- 长期主义:十年后,你的博客还在,但公众号可能已经凉了。
- 技术练习:搭博客本身就是一次全栈实践。
- 个人品牌:blog.你的名字.com 比任何平台主页都更有说服力。
最重要的是:写作本身就是一种思考。
当你试图把一个问题讲清楚时,你才真正理解了它。
六、给后来者的建议
如果你也想搭一个博客,我的建议是:
- 别纠结技术栈:选一个你熟悉的,或者直接用 Astro/Hugo 模板。
- 别过度设计:先让博客跑起来,再慢慢优化。
- 别等完美:第一篇文章不需要完美,只需要存在。
- 坚持写:哪怕一个月一篇,一年也有 12 篇。
- 享受过程:折腾本身也是一种乐趣。
结语
现在,我的博客终于有了这篇文章。
它可能不是最好的,但它是我的。
如果你也在犹豫要不要搭博客,我的建议是:现在就去做。
哪怕你只是写一篇"Hello World",也比什么都不写强。
毕竟,每个伟大的博客,都始于一篇烂文章。