展开本页目录
开始前准备什么
- Node.js 24 和 npm。
- 下载并解压本页的复现包。样例在本机运行。
- 准备样例
- 运行脚本
- 对照结果
- 核对自己的应用
下载脚本和完整输出
包含版本锁定文件、操作说明、运行脚本和原始输出。
操作步骤
- 解压样例,在解压目录执行 npm ci 和 node univer.cjs。脚本在 en-US 的 Sheets Node preset 1.0.4 测试四种写法。
- 向 C1 写入 =SUM(1,2),向 C2 写入 =SUM(1;2)。等待计算结果应用后核对 C1、C2。
- 再测 =AVERAGE({3;7}) 和 =LEN("x;y")。对照 separators 段确认数组和文本里的分号保持原义。
- 定位到目标格式的函数参数分隔符后再改。如果需迁移整批公式,保留原始表达式,使用能解析字符串和数组字面量的转换方法,并抽样验算。
关键代码
univer.cjs
javascript
const examples = [
'=SUM(1,2)',
'=SUM(1;2)',
'=AVERAGE({3;7})',
'=LEN("x;y")',
];
examples.forEach((formula, index) => range('C' + (index + 1)).setFormula(formula));
await calculate(api);实测结果
| 表达式 | 上下文 | 实际值 |
|---|---|---|
| =SUM(1,2) | 逗号分隔参数 | 3 |
| =SUM(1;2) | 分号分隔参数 | #NAME? |
| =AVERAGE({3;7}) | 分号分隔数组行 | 5 |
| =LEN("x;y") | 字符串内的分号 | 3 |
- 表达式
- =SUM(1,2)
- 上下文
- 逗号分隔参数
- 实际值
- 3
- 表达式
- =SUM(1;2)
- 上下文
- 分号分隔参数
- 实际值
- #NAME?
- 表达式
- =AVERAGE({3;7})
- 上下文
- 分号分隔数组行
- 实际值
- 5
- 表达式
- =LEN("x;y")
- 上下文
- 字符串内的分号
- 实际值
- 3
怎样确认已经完成
- 确认目标计算环境、语言和实际错误代码。
- 保留数组结构与带引号的文本。
- 对批量迁移结果重新验算。
常见问题
可以全量把分号换成逗号吗?
先区分函数参数、数组和字符串,再按公式语法修复。全局替换可能改变数组形状和原始文本。
