工程实践 1 分钟阅读

把个人博客当成长期知识库

个人博客不只是展示窗口,也可以成为长期积累、复盘和整理判断的知识系统。

写作知识管理Astro

个人博客最有价值的地方,不是一次性发布,而是把想法变成可以被重新检索、引用和修正的材料。

从问题开始

我希望每篇文章都回答一个明确问题:

  • 我解决了什么问题?
  • 当时有哪些约束?
  • 最后为什么选择这个方案?

这样写出来的内容会比单纯记录步骤更耐用。

内容结构

这个站点把内容分成三类:

  1. 文章:完整观点、教程和复盘。
  2. 项目:可展示的作品和过程记录。
  3. 随笔:短想法、观察和阶段性更新。

代码也应该被照顾

技术文章里代码块要清楚、稳定、易读。例如:

type PostMeta = {
  title: string;
  publishedAt: Date;
  tags: string[];
};

const isFeatured = (post: PostMeta) => post.tags.includes("精选");

好的阅读体验会降低重新回到旧文章的成本。

评论

Giscus 尚未配置。仓库启用 Discussions 后,把 giscus.app 生成的仓库 ID 和分类 ID 填入环境变量即可显示评论区。