年底清硬盘,我在一个叫 misc 的文件夹前停了很久。
里面横七竖八地躺着 2023 年留下的东西:几篇敲得密密麻麻的数据库课程笔记,一段还在用旧写法勉强跑通的 Node.js 服务练习,几个临时抓来救急的自动化脚本,外加几份隔了几个月重新双击打开时连自己都要皱着眉头端详半天的配置文件。它们零散地挤在同一个目录里,怎么看都不像眉目清楚的完整项目,倒更像一摞没来得及装订的活页纸;可偏偏就是这堆略显粗糙的碎片,误打误撞地成了我第一次认真保存代码的起点。
按修改时间往回翻,不难看出大二这一年自己坐在屏幕前那股急吼吼的劲儿。那时候眼里只有一件事:页面能不能顺利打开。数据库章节的课后练习刚一写完,顺手就把跑通的查询和命令往文档里一贴,仿佛截了图就算落袋为安;好不容易把本地的微型服务折腾起来,浏览器里刷出预期的那行字,我的第一反应从来不是记下刚才踩了什么坑,而是长出一口气,啪的一声把终端窗口关掉。(那时候真心觉得,屏幕上亮起想要的字样,这桩差事就算是大功告成了。)
真正让人哭笑不得的麻烦,总是在隔了几个礼拜想第二次打开它们的时候才慢吞吞地找上门。
有天室友凑过来问我某个小工具怎么跑,我挺得意地双击打开目录,却在终端前傻了眼:监听的端口号忘得一干二净,全局依赖不知什么时候升了版本,某张表为什么拆出那几个古怪的字段,我盯着屏幕想了半小时,愣是记不起半点由头。代码一行没少,安安静静躺在硬盘里,可当时写下它们时脑子里的那些来龙去脉,早就像没拧紧盖子的汽水,悄无声息地跑光了气。室友等得有点尴尬,最后说了句“那你先弄,弄好了叫我”,就回自己座位了。
好在课上那些枯燥的训练,还是在不知不觉间把我的视线往深处拽了拽。刚开始泡图书馆翻数据库教材时,表、索引、完整性约束和权限控制,在我眼里都只是期末试卷上等着默写的干瘪名词;直到自己建的表因为缺少约束被脏数据塞满,或者改了一个字段导致整条查询链跟着报错,我才猛然回过味来:原来正是这些冷冰冰的规则,在暗处决定着一份数据究竟能不能被安全地改、准确地查、清晰地解释。课程作业的体量虽然小得可怜,却像一把尺子,逼着我开始留意“谁有资格改动什么”,也让我第一次试着琢磨,当意料之外的错误撞上来时,究竟应该在哪一层把它稳稳地拦住。
如果说数据库的练习是在静态的表格里立规矩,那么 Node.js 那几段练习,就是硬生生把我推到了会动的另一端。外部请求、路由分发、远程部署和滚动的日志一旦拧成一根绳子,哪怕只是一个忘了加参数校验的微小接口,放到真实的运行链路里,眨眼间就会顺着调用栈滚出一串让人摸不着头脑的报错。折腾过几次半夜排错,我总算明白:在把一个服务放到网络上之前,至少得先跟自己交代清楚——它到底监听在哪个端口,哪些路径是真的需要向外部敞开的,万一进程半路崩了,又该敲哪条命令让它体面地重新站起来。
除开这些能跑的代码,草稿箱里其实还攒了不少只适合深夜看的碎碎念。大多是某天凌晨调通功能后的雀跃,或者是被某段环境报错折磨得焦头烂额时的吐槽,字里行间全是那几天特有的情绪,却都是零散的线头,没来得及理成文章。年底再把这些写了一半的文档翻出来看,倒也没觉得遗憾,反倒像翻到了旧课本页脚的涂鸦。把它们安安静静留在本地当成日后摸索的底稿,总比为了凑数硬发一篇空洞的总结让人踏实得多。
后来我真腾出空收拾那几个落灰的旧仓库,最先动手补上的根本不是什么新功能,而是一份薄薄的说明文档。哪怕只是一个几十行的课堂练习,我也在根目录老老实实写上三件事:它当初是为了验证什么问题写的,用什么命令跑起来,还有哪些地方当时偷了懒没做完。再顺手记下所用的 Node 版本、安装步骤、启动入口,外加一条能够亲眼看到返回结果的最小请求。遇到依赖要升级的时候,我也不再对着那个塞得满满当当的 node_modules 目录自欺欺人,而是开一个干净的文件夹从头安装一遍、跑一遍流程,把结果原封不动地写进记录里。
写完那几份说明,回头再看这些代码,它们的脾气好像一下子温和了不少。
给这一年挑个注脚的话,谈不上什么突飞猛进,更谈不上戏剧性的逆袭;说实在的,不过是终于迈出了“先把东西做出来”的那一步,又在一次次翻旧账的狼狈里,笨手笨脚地学会了给自己留路标。那些事后打上的小补丁,当然不会让 2023 年那些稚嫩的练习一夜之间变成成熟作品,却实实在在地把它们从一次性的课程作业,变成了日后随时可以抽出来重温的鲜活样本,免去了未来的自己面对满屏代码如临考古现场般的窘迫。
说到底,小项目未必非要被包装得滴水不漏才配得上归档,坦白地交代自己做到了哪里、停在了哪里,远比列出一张只写着“已完成”的漂亮清单更有分量;而许多后来长出繁茂枝叶的折腾,追根溯源,也不过是从这一年这几份并不完整、却足够真诚的记录里慢慢发芽的。
做到了哪儿、停在了哪儿,老老实实写下来就好。
关掉文件管理器之前,我把 misc 改名成了 2023。