ARTICLE · 1251389
仅4KB内存!阿波罗11号登月源码刷屏GitHub:满屏“祖安”注释,看完却让人肃然起敬

登月舱动力下降那一份源码里,有一行注释是写给宇航员的,「宇航员,请把那个蠢东西摇过来」。再往下几行,等宇航员按下确认键,程序并不相信他,跳回去重新查了一遍硬件,旁边补一句「看看他有没有撒谎」。到了着陆确认那一段,还有一句,「宇航员,现在看看你落到哪儿去了」。这些都是写在代码旁边的注释,不是屏幕上跳出来的提示。
另一面是这样的。来源里写,有位开发者把整个仓库拉下来,搜了两个词,TODO 和 FIXME,一个都没有。这是他的搜索结果,我没有重跑一遍。
一、古人把「工」定义成守住一样东西
《周礼·冬官考工记》开篇就分职。国有六职,百工居一,与王公、士大夫、商旅、农夫、妇功并列。它给百工下的定义只有一句,「审曲面势,以饬五材,以辨民器」。
再往下还有一句更要紧的话,「知者创物。巧者述之守之,世谓之工」。聪明人发明东西,手巧的人把它记述下来、守住,一代代传下去,这才叫工。
手艺人的名声不在发明了什么,在守住的东西还能用。
二、责任写在能量出来的地方
《考工记》讲制轮,讲完尺寸讲检验。轮子做好,要「可规、可矩、可水、可县、可量、可权也」,圆得合规,方得合矩,悬起来垂线不偏,放进水里浮沉均匀,装谷子量得出同容积,称起来轻重相当。六样全过,「谓之国工」。
它也不把话说满。同一篇里写,「材美工巧,然而不良,则不时、不得地气也」。材料好、手艺好,做出来仍可能不好,那是天时地气的事。话说得留有余地,尺寸那一段反倒更硬,天时管不了的地方,人自己得管住。
一句玩笑不碍事,尺寸差一分就碍事。
三、两件事各在各的位置
回到那个仓库。玩笑写在文件头和提示语旁边,是写给人看的;纪律写在每一行指令里,是写给机器跑的。中间隔着一层,谁也不越界。
点火例程那份文件的头还留着修改记录。2009 年 5 月,这一份是从 Luminary131 的对应文件改来的;6 月,「改正三个错字」;7 月,补上一段命名来历,注明来自 Don Eyles 本人的回忆。改了什么、听谁说的、哪天改的,都写在头上。
我写过代码,知道那种分寸。注释里敢放肆,是因为第二天要交付的东西不能放肆。话说得再野,尺寸上没人敢开玩笑。
满屏玩笑话,看完却让人肃然起敬。敬的是他们把玩笑和担子分得很清,两样都放在该放的地方。
资料来源 新智物种,《仅 4KB 内存!阿波罗 11 号登月源码刷屏 GitHub:满屏“祖安”注释,看完却让人肃然起敬》 阅读依据 《周礼·冬官考工记》六职与「知者创物,巧者述之守之」、轮人六验、材美工巧相关原文;GitHub 仓库 chrislgarry/Apollo-11 之 Luminary099 `THE_LUNAR_LANDING.agc` 与 `LUNAR_LANDING_GUIDANCE_EQUATIONS.agc` 注释、`BURN_BABY_BURN--MASTER_IGNITION_ROUTINE.agc` 文件头修改记录















































































