把系统里的勾选列导出成 Excel 发出去，是很多业务流程的固定动作：验收清单发给客户确认，检查表交给领导圈阅。可文件一打开就露馅了——页面上好好的复选框，在 Excel 里全变成了 TRUE 和 FALSE。客户第一句话往往是："这一列是什么？"其实是布尔值。

为什么这个细节重要

网页表格里的复选框，通常是用单元格类型实现的：单元格里存的值是 true 或 false，只是渲染和点击交互由 GC.Spread.Sheets.CellTypes.CheckBox 这一层接管。导出 xlsx 时，序列化带走的是底层值，"单元格类型"这种前端概念没有对应物可以落进文件，于是交互形态丢失，只剩下一列布尔值。

对收文件的人来说，这不只是难看。想按"是否完成"筛选、统计、标注时，面对的是文本值而不是可勾选的控件；中文报表里夹着英文逻辑值，也容易让人怀疑数据出了错。

SpreadJS 的实现思路

关键在于 SpreadJS 还有另一套机制：表单控件。通过 shapes.addFormControl 配合 FormControlType.checkBox，可以在工作表上放置真正的复选框控件形状，而这类控件在导出 xlsx 时会被还原为 Excel 原生的表单控件。于是做法是：导出前在副本上遍历整张表，遇到复选框单元格类型，就换成同位置的复选框表单控件，再清掉原格子的类型和值：

// 影子工作簿：在副本上做变换，不影响页面
let copy = new GC.Spread.Sheets.Workbook();
copy.fromJSON(spread.toJSON());
let sheet = copy.getActiveSheet();
​
for (let i = 0; i < sheet.getRowCount(); i++) {
    for (let j = 0; j < sheet.getColumnCount(); j++) {
        if (sheet.getCellType(i, j) instanceof GC.Spread.Sheets.CellTypes.CheckBox) {
            // 按行列宽高累计出该格子的位置和尺寸
            sheet.shapes.addFormControl("check box",
                GC.Spread.Sheets.Shapes.FormControlType.checkBox,
                x, y, width, height);
            sheet.setCellType(i, j, null);
            sheet.setValue(i, j, null);
        }
    }
}
copy.export(function (blob) { saveAs(blob, 'test.xlsx'); });

几个要点值得展开。用 toJSON() 加 fromJSON() 复制出影子工作簿，所有替换都在内存里进行，页面上正在编辑的表完全不受影响。控件的坐标不用 getCellRect 取——那个矩形是相对视图的，未渲染区域拿不到正确值；正确做法是从左上角起按 getColumnWidth 和行高逐格累加。替换时把原值赋给控件的 value，caption 标题文字带到控件的 text；三态复选框（isThreeState(true) 配合 textTrue/textFalse/textIndeterminate）还能按当前值映射出"是/否"等文案。最后 setCellType(row, col, null) 与 setValue(row, col, null) 清场，避免导出文件里残留多余内容。

可以扩展到哪些场景

• 质检与验收清单：合格项以带标签的复选框交付，客户可直接在文件里继续勾选。
• 审批与确认单：条款同意与否一目了然，比 TRUE/FALSE 少一轮解释。
• 盘点与物资核对：打印或归档的文件保留勾选形态，纸质流程也能衔接。
• 模板下发：系统方下发带复选框的 Excel 模板，回收后重新导入统计。
• 同类迁移：下拉框、按钮等其他单元格类型可用同样的"导出前替换"思路处理。

给开发者的关键词

GC.Spread.Sheets.CellTypes.CheckBox、getCellType / setCellType、shapes.addFormControl、GC.Spread.Sheets.Shapes.FormControlType.checkBox、toJSON / fromJSON 影子工作簿、Workbook.export、Excel 表单控件、导出保真、JavaScript 电子表格控件。

小结

复选框变 TRUE/FALSE，本质是前端渲染层概念与文件格式之间的一次翻译缺失。借助 SpreadJS 的表单控件能力和导出前的副本变换，这次翻译可以在浏览器里补齐：勾选状态、标签文字甚至三态语义都能随 xlsx 一起交出去。边界在于控件与单元格类型是两套机制，文件再导入回页面时仍需反向映射；复选框数量极大时，遍历替换也会带来少量额外耗时。