极客工场

Appearance

共 2,395 字预计阅读约 8 分钟

搭建个人IC知识库站点踩坑：个人站不是笔记堆，是一个小工程 ​

学芯片设计的人，学到第三个月几乎都会动一个念头：把笔记整理成一个自己的知识库站点，既方便自己检索，也算一份公开的作品集。这个念头本身很好，但真正做成的人不多——绝大多数站点死于「前二十篇兴致勃勃，第二十篇之后烂尾」，或者死于「换一次主题、换一次目录，搜索引擎收录全清零」。

如果你正打算动手，这篇先把结论给你，再逐条展开。学习路线本身的问题（先学 RTL 还是先学验证之类）不在本篇范围，那是另一篇的事。

本文要回答的问题 ​

  • 个人 IC 知识库站点和「把笔记扔上网」的本质区别是什么？
  • 静态站生成器那么多，选型时真正该看什么？
  • 为什么 URL 一旦发布就不能改，改动一次代价有多大？
  • 分类体系和写作顺序，哪个应该先定？
  • 配图和更新机制，怎么做才能不烂尾？

简短结论 ​

一句话：把个人知识站当工程做，而不是当笔记本用。 工程意味着：先定结构再写内容、发布的东西对外有承诺（URL 不改名不移动）、配图有固定的产出方式、更新有节奏而不是凭热情。踩坑几乎都发生在「用记笔记的心态做站点」这件事上。

理由一：静态站选型，看的不是主题好不好看 ​

新手选型的第一反应是比主题、比颜值，这是第一个坑。个人知识站要跑五年十年，真正决定生死的是四件事：

知识站选型：新手看重的 vs 真正决定生死的

读这张对比卡抓住一个原则：左边是「装修」，右边是「地基」。 装修随时能换，地基动了整站塌。具体判据有两条最硬：内容必须是纯 Markdown 文本文件（哪天不满意整个目录拷走就能换工具），产物必须是纯静态 HTML（不依赖特定托管平台、不需要数据库）。满足这两条，选哪个具体生成器反而不是大事。

理由二：URL 冻结意识——发布即承诺 ​

这是新手代价最大、也最晚才意识到的坑。知识站的价值很大程度来自外部引用：搜索引擎收录了你的页面、论坛里有人贴了你的链接、别的文章引用了你某一篇。这些引用全部指向 URL。URL 一改，所有外部入口瞬间 404，搜索引擎积累的权重清零，等于这篇从互联网上消失。

chip-design/beginner/personal-ic-wiki-pitfalls.md D2 示意图

上图里红色两块就是代价：改名这个橙色的「小动作」，引爆的是所有外部依赖。所以正确做法是反过来：发布前想清楚 slug（短、语义化、不绑年份和版本号），发布后就当它焊死了。 内容可以原地扩写、原地修订，但文件名和路径不动。真到了非动不可的时候（比如整个分类重构），也要配重定向，而不是裸改。写文档时给别的篇目做内链，同样只链「确定存在且不会动」的页面，否则你的站会自己长出一堆内生性死链。

理由三：分类先于文章——先画版图，再填内容 ​

第二个结构性大坑是「想到哪写到哪」。写了五十篇之后发现目录是按时间排的，读者（包括三个月后的自己）根本找不到东西，只好推倒重来。

搭建个人IC知识库站点踩坑：个人站不是笔记堆，是一个小工程 示意图（第 2 张）

这张思维导图就是「版图」的样子：一级分类一只手数得过来，每个分类下面能持续长出文章。先画版图的好处有三个：一是写作变成「填格子」，每一篇都有明确归属，不会写出三篇互相重复的；二是分类本身就是给读者的导航承诺，逼着你想清楚「这个站到底覆盖什么」；三是后面做侧边栏、做导读页都是版图的自然投影，不用再发明一套。

分类定不下来的时候，参考成熟的知识组织方式：比如 芯片设计流程全景 按流程阶段切分，EDA 工具链概览 按工具角色切分——看别人怎么切的，比自己凭空想要快得多。

理由四：配图要有流水线，不能每篇现想 ​

纯文字的技术站读者留不住，但如果每张图都靠临时画、现找截图，配图会成为写作最大的摩擦力，热情两周内耗尽。工程化的做法是把图分成固定的几类，每类有固定画法：

图型适用场景生产方式
结构/架构框图模块关系、数据流文本描述的框图工具，随文档一起进版本库
时序/状态机协议、握手、流程文本描述的时序图工具，同上
对比/概念卡选型、辨析固定模板填槽位
实验实录命令输出、仿真结果真实跑出来的日志截取，禁手编

关键是「文本描述、构建期渲染」：图源和文章一起躺在版本库里，改图等于改文本，不用担心哪天画图软件打不开了。概念辨析类的页面——比如 缓存一致性协议对比 那种「一张谱系图 + 几张对比表」的排版——就是很好的参照：图服务论点，每张图前后都有正文讲怎么读，不是贴上去当装饰。

理由五：持续更新靠机制，不靠热情 ​

烂尾的根本原因不是懒，是没有机制。热情驱动的更新节奏是脉冲式的：头两周十篇，然后归零。机制驱动的做法很简单，就三条：

  1. 固定频率而非固定数量：每周一篇比「这个月写二十篇」靠谱得多，频率让你形成习惯，数量目标只会制造断更后的愧疚感。
  2. 选题排队：想到题目立刻记进一个待写清单，写作时只从清单里取，不现场想「今天写什么」——现场选题是写作最大的启动阻力。
  3. 先求存在再求完美：长尾篇两千字讲清一个问题就发布，比憋一篇一万字的「完美大作」有价值。知识站是滚雪球的，一百篇各解决一个具体问题的文章，价值远超五篇宏大综述。

把这三条合起来看，你会发现它和写代码的工程实践是同构的： backlog 排队、迭代发布、小步快跑。这就是为什么开篇说个人站是个小工程——你平时在 IC 岗位地图 里看到的那些工程师做事方法，搬过来管自己的站刚刚好。

常见误区 ​

  • 误区一：先把主题调到完美再开始写。 装修可以无限拖延写作，先发布再优化。
  • 误区二：目录按时间或按首字母排。 知识库要按知识版图组织，时间排序是博客的逻辑。
  • 误区三：URL 里带日期、带「v2」「新」这类字眼。 这些都注定过期，等于给自己埋改名地雷。
  • 误区四：图靠截图和手绘照片凑。 半年后风格混乱、无法维护，图源必须文本化、可重建。
  • 误区五：等「学完」再开始建站。 学习没有学完那天，记录当下理解就是最有价值的内容。

延伸阅读 ​

一句话总结 ​

搭建个人IC知识库站点踩坑的根源只有一个：用记笔记的心态做站点。把它当小工程——选型看地基（纯 Markdown、纯静态产物）、URL 发布即冻结、分类版图先于写作、配图走文本化流水线、更新靠选题队列和固定频率——站就能活过热情消退的那一天，真正长成你学习 IC 的第二大资产。