把编译缓存当“中央厨房”:scriptc 的 cache warm,凭什么让 CI 少等好几分钟?
把编译缓存当“中央厨房”:scriptc 的 cache warm,凭什么让 CI 少等好几分钟?
如果你身边有做开发的朋友,大概见过这种画面:代码改了一个标点,提交,然后盯着 CI 的转圈动画,去接水、上厕所、刷两条短视频,回来一看——还在编译。
这两年,一个叫 scriptc 的开源项目在技术圈频繁被提起。它干的事说起来有点猛:把 TypeScript 直接编译成原生的可执行文件,不需要 Node.js,也不需要 V8 引擎。有测评提到,它做出来的程序冷启动只要 5~15 毫秒,内存占用比传统方案低四到六成。
但今天不聊“它跑得多快”,聊一个更接地气、也更让团队心疼的话题:每次构建都要重新等一遍,这时间到底能不能省?
scriptc 给出的答案,就是一条几乎没人注意的小命令——cache warm。
一、先搞懂:这条命令到底在干嘛?
你可以把编译一个程序,想象成开一家小饭馆。
客人点单(你敲下构建命令)那一刻,后厨才开始洗菜、切肉、熬高汤、发面……等菜端上桌,客人已经饿得想走了。
cache warm 干的事,就是开门营业前先把“高汤”熬好、“配菜”切好。
它不是帮你编译你的业务代码,而是提前把那些每次构建都要用到、又特别费时间的基础材料准备好,放进一个持久的缓存仓库里。等真正构建的时候,直接取现成的。
而且它很实在,跑完会在终端里打印两样东西:缓存放在哪个目录,以及每一档预热花了多少毫秒。哪一档慢、哪一档快,一眼就能看出来。
这里要先说一句大实话:普通开发者日常构建,其实不需要手动跑这一步。 官方文档写得很清楚,这只是给 CI、给频繁全量构建的团队准备的“提速开关”。
二、凭什么敢“直接用现成的”?靠的是给每个文件发身份证
很多人第一反应是:缓存这东西不靠谱吧?万一我改了代码,它却拿了旧的,不就出大事了?
这正是 scriptc 这套缓存最值得说的设计,用大白话讲就是:不按文件名认人,按“内容”认人。
打个比方。传统的缓存像门卫看脸:你叫张三,就放你进。可要是有人也叫张三呢?就乱了。
scriptc 的做法是内容寻址:它不看文件叫什么,而是把文件内容算成一串长长的“指纹”(SHA-256 校验值)。内容差一个字符,指纹就完全不同,等于换了个人。
更狠的是,这个指纹不只算你的代码。它还要把你的编译器版本、目标平台、系统头文件、链接器身份、运行时包、优化档位全都揉进去,最后生成一个唯一的“身份证号”。
所以会出现这种情况:你把某行代码删掉一个空格,指纹变了,缓存不认;你把注释改了,指纹又变了,缓存还是不认。宁可重算,也绝不给你一个“看起来一样、其实不一样”的结果。
这份“死板”,恰恰是它敢在 CI 里用的底气。
三、预热到底预哪几档?像套餐一样点
cache warm 支持你“点名”要预热哪几类,常见的两档是:
runtime(运行时)——程序跑起来要用的那些基础设施,相当于饭馆里的灶台、冰箱、水电。它是最大头、最耗时的一块。
tls(加密通信)——涉及 HTTPS 请求的那套加密能力,体积不小,编译也不便宜。平时用不上,一用上就得等。
另外在一些内置的调用路径里,还会把 dynamic(动态引擎) 那一档一起算进去。你可以理解成:有些程序里难免夹着一点“没法完全静态化”的 JavaScript,需要一个小引擎兜底,这块也要提前备好。
还有一个开关值得单独提:加 --sanitize。
这个模式不是给生产用的,是给“体检”用的——它会给程序加上内存检查和引用计数审计,专门用来抓那些藏得很深的 bug。因为要动用 C 编译器重新构建一遍带检测的运行时,所以更慢。放到 CI 里提前热好,效果立竿见影。
四、五条实战技巧,都是从坑里爬出来的
第一条:卡准时机。
别等到构建开始才想起来预热。正确姿势是在 CI 的“准备阶段”就调用,比如依赖装完、代码拉下来之后。让它和别的准备工作并行跑,等于白赚一段时间。
第二条:把缓存目录固化下来。
缓存默认放在用户目录下的一个隐藏目录里。但 CI 的机器往往是一次性的,跑完就销毁——你不把目录挂出来或者缓存起来,热完就没了,等于白忙活。把缓存根目录指到一个可持久化的位置,才是关键一步。
第三条:点名要,别全都要。
如果你的项目根本不做 HTTPS 请求,那就只热 runtime 那一档。少热一档,就少占一份空间,也少花一份时间。同理,只跑 Linux 流水线,就别去折腾别的平台。
第四条:档位必须对齐。
这一点特别容易翻车。你用 release 档预热,构建时却用了 dev 或 speed,指纹对不上,缓存一次都用不上,纯纯的自我感动。预热时的优化档位、目标平台、编译选项,必须和真实构建一模一样。
第五条:给缓存留足空间。
默认上限是 4GB。如果你手动设了一个很小的上限,预热刚写完就被“清理程序”当垃圾扫地出门了。scriptc 甚至会直接报错提醒你:上限太小,装不下你要预热的档位。别硬撑,给够空间。
五、三个“保命机制”,比提速更重要
缓存键一致性。 前面说的指纹,必须覆盖所有会影响产物的因素。少算一项,就可能出现“改了配置却命中旧缓存”的幽灵 bug。scriptc 连系统头文件的依赖内容、链接器和汇编器的身份都算进去了,就是为了堵这个洞。
环境不可降级。 这句话听着绕,翻译过来是:宁可不用缓存,也绝不用可疑的缓存。
比如你把缓存目录指向了一个权限过于开放的文件夹,它会直接绕过缓存,而不是去改你的目录权限;你设了环境变量关掉缓存,它就老老实实从头编。还有,手机端和 WASI(浏览器/边缘环境跑的那种 WebAssembly)这类目标,压根不支持预热,会直接告诉你“这功能对你不适用”,而不是假装成功。
修剪与校验。 缓存里的东西被当成“可丢弃的临时数据”对待,不是可信产物。每个文件旁边都配一份校验值,取用之前先核对;磁盘损坏、手动截断、上次写到一半断电的半成品,都会在进入编译器之前被拦下。空间不够时,按“最久没用过”的顺序清理,清到只剩上限的 75%,给后续写入留出余量。
六、提速到底有多明显?看两组真实数字
项目更新日志里有两个很能说明问题的对比:
一个是 23 个模块的程序,什么都没改重新构建,从 1.26 秒降到 93 毫秒。
另一个更夸张:项目自己那个用 TypeScript 写的类型检查器,开发档位下从 58.2 秒降到 1.6 秒。
58 秒和 1.6 秒的差距是什么概念?前者够你泡一杯茶再回来,后者你眨个眼就结束了。而这还只是“前端那一层”的缓存。cache warm 补上的,是更靠后的原生运行时和链接那一大块。
当然,也得说句公道话。网上对 scriptc 并非一片叫好:InfoQ 就报道过“启动快 12 倍,运行却慢 7.5 倍”的实测结论,也有测评指出它的全量编译比传统方案更慢,只是增量构建优化明显。
这其实不矛盾。它走的是“前期多花点功夫,后期一直占便宜”的路线。而 cache warm,就是把这笔“前期功夫”提前到 CI 的空档里做掉。
七、普通人要不要碰?门槛在哪
说句实在话:这东西的目标用户不是普通上班族,而是写代码的团队,尤其是那种一天要跑几十上百次流水线、被构建时间折磨到麻木的团队。
不需要显卡,不需要什么特殊硬件。一台普通的 CI 机器,装好编译器,跑一条命令就行。真正需要动脑子的,是想清楚三件事:我的缓存放在哪、我要热哪几档、我的档位有没有对齐。
顺带一提,安装依赖的时候,scriptc 本身就会顺手把与工具链匹配的 runtime、TLS 和动态引擎产物热一遍。也就是说,很多团队其实已经在享受这份红利,只是不知道背后发生了什么。
写在最后
我们总在讨论“编译有多快”,却很少讨论“有多少工作其实根本不用重做”。
scriptc 这套设计真正聪明的地方,不在于它把某个算法优化了多少倍,而在于它把工程里最朴素的一条常识做到了极致:同样的活儿,别干第二遍;要干,也得先确认真的是同一件活儿。
从“每次从零开始”,到“开门前先备好菜”,这中间省下的不只是几分钟,更是一个团队每天被打断几十次的心流。
最后抛个问题给大家:你们公司的 CI 构建,一次要等多久?是几分钟,还是够你下楼买杯咖啡再上来?如果有个开关能把这时间砍掉一大半,你愿意为它多配一块硬盘吗?评论区聊聊。