昨天半夜两点，我盯着电脑屏幕，眼睛干得像撒了把沙子。

不是因为我熬夜打游戏，而是我在折腾那个搞了半年的“个人知识库”。

说实话，当初想建设文库网站，念头挺单纯的。

就是觉得网上资料太散，今天百度，明天知乎，后天还得去GitHub翻代码。

我想把那些碎片化的好东西，像收破烂一样，全捡回家，整整齐齐码在架子上。

听起来很美，对吧？

现实很骨感。

刚开始，我用了WordPress，装了个文档插件，觉得万事大吉。

结果上传了五十篇PDF，网站加载速度直接掉到3秒开外。

用户访问体验？不存在的。

后来我又换了Hexo，搞静态生成，速度是快了，但管理起来简直是噩梦。

每次更新个目录，得在命令行里敲一堆代码，手抖一下，链接全挂。

那种挫败感，就像你精心做了一桌菜，端上桌发现盐放成了糖。

这半年，我试了不下五种方案，头发掉了一把，终于摸索出一条还算靠谱的路子。

今天不聊虚的，就把我血泪总结出来的步骤，掰开了揉碎了讲给你听。

如果你也想建设文库网站，别急着买服务器，先看看这几点。

第一步，选对核心引擎，别贪大求全。

很多人一上来就想搞个大平台，什么会员系统、评论互动、社交分享，全都要。

大错特错。

文库网站的核心是什么？是“存”和“找”。

我最后选的是Docusaurus，或者类似的静态站点生成器。

为什么？因为它天生就是为文档设计的。

Markdown写内容，配置一下就能生成漂亮的目录树。

不用维护数据库，不用担心被黑客攻击，部署在GitHub Pages上，免费还稳定。

对于个人或小团队，这就够了。

第二步，建立严格的分类逻辑，别搞“其他”文件夹。

这是我以前最大的毛病。

文件多了，我就懒得分类，全扔进“其他”或者“未整理”。

结果想找个东西，跟大海捞针似的。

现在，我强制自己遵循MECE原则，也就是相互独立，完全穷尽。

比如，我把文库分成：技术栈、生活随笔、资源工具、读书笔记。

每个大类下，再细分小类。

比如技术栈下面，分前端、后端、运维。

命名要规范，不要用“新建文件夹1”，要用“2023-10_React进阶笔记”。

这样，哪怕过了三年，你再看，也知道这是什么。

第三步，做好元数据管理，让搜索变得智能。

光有分类还不够，你得让机器读懂你的内容。

我在每篇文章的头部，都加了YAML front matter。

比如：

title: 标题

tags: [React, 前端, 性能优化]

date: 2023-10-27

这样，我就能通过标签快速聚合内容。

比如我想找所有关于“性能优化”的文章，点一下标签，全出来了。

这一步，前期麻烦点，后期真香。

第四步，定期清理，断舍离。

文库不是垃圾场。

那些过时的教程、看了一半就扔的代码片段，该删就删。

我每个月会花半小时，审视一下自己的文库。

问自己一个问题：这篇东西，半年后我还用得着吗？

如果答案是否定的，删。

保持文库的轻盈，才能跑得快。

最后，说说心态。

建设文库网站，不是为了炫耀，也不是为了流量。

它是你思维的延伸，是你知识的锚点。

别指望一夜建成罗马。

哪怕每天只写一页笔记，一年下来，也是一座小山。

我现在的文库，大概有两千多篇文档。

每次遇到新问题，打开搜索框，输入关键词，那种掌控感，真的爽。

虽然偶尔还是会遇到链接失效，或者排版错乱的小bug。

但比起那种满世界找资料的焦虑，这点小麻烦，值得忍受。

你也试试？

别等完美了再开始，先动起来。

哪怕先从建一个文件夹开始。

本文关键词：建设文库网站