SheetJS 入门:批量转换游戏配置表
从安装 SheetJS 开始,学习读取 Excel 与 CSV、修改表格数据,并导出为 JSON、CSV 或其他表格格式,快速完成游戏配置批处理。
- 1
准备运行环境
安装 Node.js 18 或更高版本,新建项目目录并执行 npm init -y,再通过 npm install xlsx 安装 SheetJS。
- 2
读取表格文件
新建 convert.js,使用 xlsx 的 readFile 方法加载本地 .xlsx 或 .csv 文件,并用 sheet_to_json 将首个工作表转成对象数组。
- 3
检查字段与数据
先打印转换结果的前几行,确认表头、中文字段、空值及数据类型;若首行不是表头,可在读取时设置 header: 1。
- 4
批量修改配置
遍历对象数组,按字段筛选或更新配置,例如将 status 改为 enabled;同时处理缺失字段,避免直接覆盖不存在的属性。
- 5
导出 JSON 和 CSV
使用 json_to_sheet 创建工作表,通过 book_new、append_sheet 和 writeFile 导出 .xlsx;CSV 可直接用 sheet_to_csv 后写入文件。
- 6
接入项目流程
将脚本加入 package.json 的 scripts,接收输入和输出路径参数,再通过 npm run 命令重复处理运营提供的配置文件。
💡 实用技巧
- 用 sheet_to_json 检查实际表头
- 统一日期和数字字段类型
- 大型表格可按文件分批处理
- 商业场景需确认授权范围
⚠️ 常见坑
- 不要默认第一张表就是目标数据
- 公式与格式不会完整保留
常见问题
Q:安装 SheetJS 后为什么找不到 xlsx 命令?
先确认已安装 Node.js 18 或更高版本,并在项目目录执行 npm init -y 和 npm install xlsx。脚本中使用 require('xlsx') 引入模块,再通过 node convert.js 运行;不要把 xlsx 当作可直接执行的终端命令。
Q:读取表格后怎样确认字段和类型是否正确?
先打印 sheet_to_json 转换结果的前几行,检查实际表头、中文字段、空值及数据类型。若首行不是表头,可在 readFile 的读取选项中设置 header: 1;修改前还应补齐脚本依赖的缺失字段。
Q:如何把转换脚本接入日常配置流水线?
在 package.json 的 scripts 中添加调用 convert.js 的命令,并让脚本接收输入、输出路径参数。运营文件可按批次逐个传入,再用 npm run 重复执行;JSON、CSV 或 .xlsx 输出后即可供后续流程使用。