连锁餐饮企业的区域督导,每月要交一次门店巡检表。表格在 WPS 里做,一列是检查项,冷柜温度、后厨地面、消防通道,一列贴照片,都是巡店时用手机拍的。总部今年上线了网页版复核系统,前端表格用的是 SpreadJS,一款纯前端的 JavaScript 电子表格控件,平时导入 Excel 文件一直正常。督导把巡检表传上去,复核同事打开,检查项在,评分公式也在,照片那一列却空了,单元格里躺着一串没人认识的函数。
文件被退回重传了三次。网络没问题,文件也没坏,照片确实还在里面,只是存放的位置和普通 Excel 图片不同。复核同事后来只问了一句,照片呢。
退回之后,复核只能对着附件里的原文件逐行比对,效率比纸质表还低。督导那边则要重新拍照、重新贴图,一天跑三家店的时间就这么耗掉。
巡检表里的照片,本来就不该浮在表格上
做过门店检查的人知道,这类表最常见的用法是先按门店排序,再按不合格项筛选。照片如果是浮在表格上方的独立对象,插入一行、删掉一行、重新排序之后,它就和对应的检查项错开位置。用户得手动把图拖回去,几十行改下来很容易乱。
WPS 的单元格内图片解决的就是这件事。图片属于单元格,行挪到哪里,图跟到哪里。国内的巡检表、设备点检表、供应商送货单大量采用这种做法,文件在微信里传来传去,收件人用手机或电脑打开都能看到照片。这个习惯一旦形成,表格搬进 Web 系统时就会被原样带过来。
而且这些表格的收件人往往不关心技术细节,他们只用肉眼确认照片有没有跟对行。对总部来说,这类表的价值在于留痕,照片和检查项必须待在同一行,审计时才对得上号。
一张照片在 xlsx 里要走两段索引
普通 Excel 图片是浮在表格上方的对象,有自己的坐标和尺寸,跟单元格没有绑定。打开 xlsx 压缩包,能在 xl/drawings 里看到它的位置记录,在 xl/media 里看到图片本身。
WPS 的嵌入图片走另一条路。单元格里存的是一个公式,形如 =DISPIMG("ID_...",1)。DISPIMG 是 WPS 自己的函数,浏览器和大多数表格引擎都不认识。图片字节仍然放在 xl/media 下,但要找到它,得先经过 xl/cellimages.xml。这个文件记录了图片 ID 和关系 ID 的对应,关系 ID 再通过配套的 .rels 文件指向具体的媒体文件。这套结构是 WPS 保存文件时额外写进去的,标准 xlsx 里没有它。
于是一份带单元格图片的 WPS 表格,索引是两段式的。公式里是图片 ID,图片 ID 在 cellimages.xml 里换成关系 ID,关系 ID 在 .rels 里换成文件路径,最后落到 xl/media 下那张图。中间任何一段接不上,图就出不来。
故障的样子也由此而来。单元格里的公式还在,检查项和排版都正常。公式指向的图片没有被解析,照片位置空着,或者显示成错误值。用户看到的是图丢了,文件里断掉的是这条索引。
同一个媒体文件被多个图片 ID 引用的情况并不少见。巡检表里同一处破损拍一次、用在好几行,解析时要按关系 ID 归类,让一个关系 ID 对应多个图片 ID,否则会漏掉后面几行。
导入器只认标准件
SpreadJS 通过标准导入通道读取 xlsx,标准格式里的内容有对应的处理路径。DISPIMG 不在标准函数表里,导入器没有理由认识它。文件进来之后,单元格保留的是一条算不出结果的公式,图片没有出现的机会。
这个问题换一个导入参数也解决不了,文件里那层索引需要有人先去读,读懂了再翻译成表格引擎认识的写法。通用 Web 表格的导入器都会遇到同一个坎,文件格式里的私有约定,只有知道它的人才能翻译。这个缺口要补在导入前后的一层预处理里,导入器本身不需要改。
把索引拆开,再把图片放回单元格
做法可以分成四步,前两步读文件,后两步往表格里写。
第一步,先用 SheetJS 扫一遍工作簿,找出所有公式里带 DISPIMG 的单元格,记下工作表名、单元格地址和图片 ID。同时用 JSZip 打开同一个 xlsx,读 cellimages.xml 和相关的 .rels,把图片 ID、关系 ID、媒体文件串起来,再把媒体文件转成 base64。这一步不碰 SpreadJS,纯粹是读文件结构。
第二步,让 SpreadJS 照常导入,在导入完成的回调里新建一张工作表,把可见性设为 veryHidden,把上一步得到的 base64 按行写进 A 列。再用 CalcEngine.rangeToFormula 生成 srcSheet!$A$1 这样的引用,建立图片 ID 到单元格引用的映射。veryHidden 的工作表不出现在工作表标签里,业务表因此保持干净。
第三步,回填公式。遍历第一步记下的地址,用 getSheetFromName 找到所在工作表,用 CalcEngine.formulaToRange 把 Sheet1!D5 这样的文本转成行列坐标,再 setFormula 写入 =IMAGE(srcSheet!$A$3)。IMAGE 是 SpreadJS 认识的函数,参数可以指向一个单元格,引擎会取出那个单元格里的 base64,渲染成图片。
第四步,处理重绘。整段遍历包在 suspendPaint 和 resumePaint 之间,上百张图不会每写一条公式就重绘一次,导入过程不闪。收尾时用 setActiveSheet 回到业务表。
选 base64 有一个很实际的原因。文件在用户本机,没有可访问的 URL,图片转成 base64 后跟着工作簿走,不依赖外部服务,断网也能显示。
把编码放进隐藏表,也有它的道理。一段图片编码动辄几十万个字符,直接写进 IMAGE 的参数,每个格子的公式都要带着同样长的字符串,既难维护,也不利于同一张图在多行复用。放进单元格之后,公式里只留一个短引用,图片数据只有一份。
图片以公式结果的形式落在单元格里,和单元格绑在一起,不会另外生成一个浮在表格上方的图形。业务表的对象数量不会因为照片而暴涨,行列移动时,图和它所在的行一起动。
桥接做到哪一步,哪里还留着口子
这套做法覆盖的是最常见的混合办公场景。总部用 Web 系统,分支用 WPS,文件在两边来回。导入之后照片留在原来的位置,评分公式照常计算,督导不用重拍一遍再贴一遍,复核同事也不用对着附件里的原文件逐行核对。
边界也要说清楚。解析逻辑依赖 WPS 的打包方式,cellimages.xml 的位置、.rels 的组织方式,任何一处变化都可能让映射失效。碰到别的办公软件自带的嵌入方式,这套代码要另写。公式匹配也限定了形态,只认 DISPIMG("ID", 数字) 这一种写法,少了第二个参数就不会命中。
DISPIMG 的第二个参数表示图片在单元格里的显示方式。代码把它读出来了,导入时没有使用。图片能显示,但缩放和铺排的细节可能和 WPS 里看到的并不完全一致。巡检表这类以记录为主的场景,这个差别可以接受;版式要求严格的报价单,需要额外处理。
base64 存在工作簿里,图片越多,内存占用越高。几十张照片的巡检表没有压力,上千张图的房源册、商品目录要先做评估,必要时改成按需加载。
业务里如果同时有 Excel 的浮动图片和 WPS 的单元格图片,两条路径要能共存,处理一种的时候不能把另一种弄丢。上线前值得拿真实业务文件跑一轮,把多工作表、同一张图反复引用、隐藏行列这些情况都覆盖到。WPS 版本更新之后,解析代码也要重新验证。
这些边界不影响结论。它做的是一层格式桥接,成本主要在维护上,得跟着 WPS 的文件结构走。
选型的人、做产品的人和写代码的人
做选型的人,Excel 兼容的清单里通常写着公式、图表、条件格式、打印。可以再加一条,文件从 WPS 来的时候,这套表格接不接得住。国内企业的现实是两套办公软件长期并存,总部和分公司用的软件常常对不上,一份文件在两边来回是常态。让供应商拿一份真实的 WPS 巡检表当场导入,比对着功能清单逐项打勾更能看出差别。
做产品的人要留意用户的表达方式。没有人会说“我要支持 DISPIMG”,他只会说“我那张表传上来照片没了”。这种落差出现在迁移的第一天,用户对系统的信任也在那一天建立。补上这一个细节,比多加三个功能更能让人愿意留下来用。
写代码的人能看到另一面。SpreadJS 开放的是可编程的一层,导入回调、公式、工作表可见性、批量重绘都能控制,格式差异可以在业务侧补,不必等控件厂商排期。代价是这段解析代码得自己维护,跟着上游的文件格式演进。它提供的是类 Excel 的表格引擎,文件里多出来的东西,仍要应用自己伸手去接。
用户只会记得照片在不在
那位督导后来不再追问原因。他只关心下一份表传上去,照片还在不在原来的格子里。
一张巡检照片决定不了系统的好坏。但在上传文件的那一分钟里,照片在不在,差不多就是他对这套系统靠不靠谱的全部判断。
像 DISPIMG 这样的函数名,业务人员一辈子都不会听说。它却决定了那份巡检表能不能顺顺当当搬进浏览器。把这张表搬进浏览器的人,得先知道照片原本待在哪儿。