开发实践 · 复盘

单文件 App 的零构建工作流与天花板

工具箱里的 12 个单文件 App 和这个站点本身共用同一套哲学:打开就是全部,复制就是部署。这篇复盘写清楚这条路的收益、纪律,和它真实的尽头。

结论:单文件是发布物的极佳形态,但当样式层数、数据体量或协作人数越过阈值,它就不该再是开发介质。

为什么坚持单文件

零依赖、零构建、离线可用、拷贝即备份。对个人工具,这四条抵得上所有工程化收益:写完 double-click 就能用,十年后还能打开。

让单文件活下去的纪律

  • 数据与表现分离:内容进数据对象,改内容不碰模板
  • 逐版本追加而不是原地修改,直到定期归并
  • 每版都留独立文件,坏了随时回滚
  • 自动化回归(几何比对 + 功能清单)代替手工点验

天花板在哪里

这个站点自己就是答案:样式在 V52 期膨胀到 28 层、三千多个 !important,归并花了一整版的力气。文本编辑器在 40 万字符的文件里的每次全文搜索、每次误改风险,都是复利式成本。

什么时候该工程化

三个信号出现任何一个:需要第二个人改代码;需要按环境出不同构建;出现"不敢动"的区域。届时正确形态是源码目录 + 构建期内联回单文件——发布物不变,开发介质换掉。

#开发实践 #复盘

这篇文章有对应的论坛讨论串:单文件站点的回归验收方法交流

讨论

1 条

评论公开可见,支持 Markdown。后端不可达时本区自动进入只读模式。

  • Randy Hopkins 作者

    欢迎讨论。登录后即可发言,评论公开可见,你可以随时删除自己的评论。这里期待的是围绕文章内容的经验与勘误——我会定期回来逐条处理。

正在加载讨论…