十二次提交,从 2024 年 4 月 24 日到 5 月 6 日。
vue3-basic 这个仓库,是我大二下学期断断续续攒出来的。那十来天里课表不算满,我经常在宿舍一坐就是一下午,开着官方文档,左边编辑器右边浏览器,看一节,敲一点,提交一次。
现在顺着 Git 记录往回翻,读起来像一本按天记下的实验周记:第一天用 Vue CLI 搭起带 TypeScript 的项目骨架,接着在组件里挨个摸 ref、响应式对象和生命周期钩子的脾气;4 月 29 日,第一次试着把散落在组件里的鼠标坐标逻辑抽成一个独立的 Hook;5 月 2 日写了一个拉取远程数据的 URL Loader,隔天大概是越看越觉得类型提示不够顺眼,又回头给它的返回值补上了泛型支持;再往后的几次提交,便慢慢变成了 Teleport、Suspense 和全局 API 变化的读书笔记。
刚学完那阵子,我很爱用一句话总结组合式 API:让逻辑回到同一个地方。听起来挺圆满的。直到后来重新点开这棵代码树,我才忍不住对着屏幕笑了一下:哪有什么一步到位的优雅架构,留在仓库里的真实痕迹,分明是一排随手摆在桌角的小玻璃瓶,每一次提交只够腾出手来触碰一个新概念,有的装满了,有的装到一半就搁下了。
第一个 Hook,其实只记录点击
最先抽出来的是 useMousePosition.ts,结构简单到一眼能望到底。函数里定义了 x 和 y 两个响应式数值,组件挂载时在全局 document 上注册一个 click 监听;每当页面被点击,就从事件对象里读 pageX 和 pageY 更新坐标;组件卸载时,再用同一个函数引用把监听干干净净地摘掉,对外只暴露 x 与 y。
就这十几行代码,第一次让我尝到了组合式 API 在组织逻辑上的甜头。从前写选项式 API 时,状态声明在 data,事件监听挂在 mounted,清理逻辑又得隔着老远写进 beforeUnmount,组件稍长一点,就得上下滚着鼠标对照哪个跟哪个是一伙的。而在这个 Hook 里,响应式状态、事件注册、卸载清理以及最终的返回值全都安顿在同一个函数作用域内,注册与销毁握的是同一个函数引用,外面的组件什么都不用操心。我当时盯着它看了好几遍,有种把乱糟糟的抽屉终于收拾整齐的痛快。
不过它的文件名其实留了一处名不副实的破绽:useMousePosition 听上去会随着光标滑过屏幕而实时追踪位置,可代码里实际绑定的却是 click 而非 mousemove。手不按下去,屏幕上的坐标数字就纹丝不动。(那会儿我在浏览器里点了几下,看见数字跳了,卸载时也没报错,就心满意足地提交了,压根没想起来要晃一晃鼠标试试。)
第二个 Hook,碰上了异步
隔几天写的 useURLLoader.ts,开始试着往组合式函数里塞异步网络请求。它接收一个字符串 URL,在被调用的那一刻就立刻触发 axios.get,同时往外交出四个响应式状态:结果数据、加载中、已完成与错误。请求成功就填入结果并改写加载标记,中途失败则把异常存进错误状态里。
把这个文件提交进仓库的第二天,我在组件里拿它渲染不同格式的接口数据,被生硬的类型推断折腾得够呛,于是又专程补了一次提交,把结果状态改成带泛型的 ref<T | null>。这一下改动非常解渴:不仅把初始的空值显式摆上了台面,也让调用端在传入不同地址时能够自己声明期望的响应结构。同一个加载函数,终于不再只认某一种特定格式的图片接口,类型定义得以从外部自然地传递进来。
只是那时候光顾着为泛型跑通高兴,异步请求底下那些暗礁一块都没碰。axios.get 是在函数调用的那一刻直接发出去的,和组件的生命周期并没有真正对齐;倘若网络慢了一拍而组件已经提前卸载,迟到的响应照样会去改写状态;要是外部连续换了几个 URL,前一个慢请求完全可能在后一个请求完成之后才回来,悄悄用旧数据把最新的结果覆盖掉。请求取消、超时控制、失败重试、用来排先后的请求序号,一样都没有。如今回头看,那时的代码确实帮我推开了状态抽离与泛型函数的大门,但门后关于异步竞态与生命周期对齐的难题,还要等后来在真实项目里摔过几次跟头才慢慢学会处理。
README 跑得比代码远
如果只看仓库根目录下的 README,会以为那十几天我学得相当渊博:从生命周期对照表,一路写到 Teleport、Suspense 以及 Vue 3 全局 API 重构,目录工工整整,还摘了不少框架特性的原理解析与官方示例。可一旦点开源码目录就露馅了——真正落进 .vue 和 .ts 文件里的,只有响应式的基础练习、那两个 Hook、一个实验性质的异步组件,再加一个用 Teleport 挂载的弹窗。剩下的大片篇幅,都是我深夜看教程时顺手记下的读书笔记。
打开 package.json,当时声明的依赖范围是 Vue ^3.2.13、TypeScript ~4.5.5、Vue CLI ~5.0.0、Axios ^1.6.8,锁文件里实际固定的则是 Vue 3.4.25、TypeScript 4.5.5、Vue CLI 5.0.8、Axios 1.6.8。至于自动化测试,仓库里一行测试脚本都没配过。点击监听有没有摘干净,异步请求成功和失败对不对,全靠我自己在浏览器里刷新、拿鼠标点按确认。
两年后再跑一次构建
到了 2026 年 8 月的一个周末,清理本地目录时,我一时兴起把这个仓库最后一条提交重新检出来,想看看这坛封了两年的“老酒”还能不能顺利倒出来。
没想到第一步就被拦住了:电脑上的 pnpm 10.6.4 在冻结模式下读不懂当年那份 v6 格式的锁文件,安装刚起头就报错停摆。直到我把工具链临时切回 pnpm 8.15.9,依赖才哗啦啦地装完。接着跑生产构建,状态码 0 正常退出,静态文件也产出来了,只是终端屏幕上滚过去几行黄色的 ESLint 警告。
我有点好奇,又单独跑了一次仓库自带的 lint 脚本。结果毫不客气:两个 error,七个 warning。两个 error 全在最早用来演示语法的那个 JavaScript 文件里——一处是试图给已经用 const 声明的常量重新赋值,另一处是在同一个作用域里粗心地重复声明了同名变量;七个 warning 则散落在各个练习文件里,既有导入后忘了使用的生命周期钩子和类型,也有当时图省事随手写下的显式 any。
看着终端里那几行红红黄黄的提示,我一边清理临时目录,一边觉得挺有意思。比起笼统地感叹一句“两年前的项目居然还能跑”,被锁文件拦下、又被 lint 抓出偷懒痕迹的过程,反倒让那个对着屏幕一点点试错的初学者模样变得鲜活起来。
这份练习仓库终究没有长成什么工程模板。它扎扎实实做完的,其实就两件小事:把点击坐标和事件清理收进同一个函数,让挂载与卸载在同一个作用域里首尾相顾;把 Axios 请求的加载状态抽出来,摸索着给返回值加上了泛型参数。
那两个 error 我没去修。就让那些半途停下的 Hook 和未曾清零的 lint 警告一起,安安静静留在 2024 年 5 月 6 日吧。也算是给当年那个在桌前敲代码的自己,留了一张不加修饰的快照。