我搭了个博客,然后花了 3 个月才写下了文章

5 阅读6分钟

程序员搭建个人博客的真实生命周期:搭站 3 天,折腾主题 3 周,写第一篇文章 3 个月。

前言:每个程序员都有一个博客梦

每个程序员的人生中,大概都会经历这样一个循环:

  1. 看到别人的博客很酷 → 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,为什么还要自己搭一个?

我的答案是:

  1. 完全掌控:不被平台算法绑架,不被删帖,不被限流。
  2. 长期主义:十年后,你的博客还在,但公众号可能已经凉了。
  3. 技术练习:搭博客本身就是一次全栈实践。
  4. 个人品牌:blog.你的名字.com 比任何平台主页都更有说服力。

最重要的是:写作本身就是一种思考。

当你试图把一个问题讲清楚时,你才真正理解了它。

六、给后来者的建议

如果你也想搭一个博客,我的建议是:

  1. 别纠结技术栈:选一个你熟悉的,或者直接用 Astro/Hugo 模板。
  2. 别过度设计:先让博客跑起来,再慢慢优化。
  3. 别等完美:第一篇文章不需要完美,只需要存在。
  4. 坚持写:哪怕一个月一篇,一年也有 12 篇。
  5. 享受过程:折腾本身也是一种乐趣。

结语

现在,我的博客终于有了这篇文章。

它可能不是最好的,但它是我的。

如果你也在犹豫要不要搭博客,我的建议是:现在就去做。

哪怕你只是写一篇"Hello World",也比什么都不写强。

毕竟,每个伟大的博客,都始于一篇烂文章。