边学边写：把新手期的困惑留在纸上
来源: purplesyringa.moe — 2026-09-19
概述
作者主张在刚学会一件事、还清楚记得自己卡在哪的时候立刻写下来。他以自己上手 Minecraft 模组为例：KubeJS 用 ServerEvents.tags('item', event => ...) 注册物品，他一度不理解 ServerEvents 是什么、为什么操作要写在闭包里、为什么叫 event，直到读完 KubeJS 文档与源码、再顺着追到 NeoForge 的文档和源码，才明白这其实是 NeoForge 在启动阶段同步投递的生命周期事件。作者的抱怨是：市面上的资料不是写给初学者的，就是写给专家的，唯独缺少衔接这两端的中间层。
核心要点
- 写下来的最佳时机是「刚刚挣扎完、终于找到答案」的那一刻，因为此时你同时记得自己的困惑和该搜索的词。
- 为了搞懂 KubeJS 的那一行代码，作者读了 KubeJS 文档、KubeJS 源码、NeoForge 文档、NeoForge 源码，才发现它用的是 mixin/补丁点的机制，只是沿用了事件这个名字。
- 现有资料的两个极端都不够用：「专家写给专家」的维基和「专家写给五岁小孩」的科普一样让人抓狂。
- 他反问读者：如何让一个只听过「HTTPS 是安全的」的人，在不知道非对称加密是核心的前提下，从维基的 HTTPS 词条走到 Diffie-Hellman。
- 记录失败同样有价值：「只要有一个人像你一样卡住，就有十个人能轻松理解答案却没能找到它」，维护者会为此感谢你。
金句
只要有一个人像你一样卡住，就有十个人能轻松理解答案，却没能找到它。
👍 0
👎 0
← 返回 Lobsters 首页