Excel-compatible spreadsheet formula engine in MoonBit
状态(2026-11-15,M7 引擎增强):60 函数引擎(MoonBit,ADR 0007 扩列 +10)、native CLI、wasm-gc playground、mbtexcel 读→算→写示例已实现;新增 AST 缓存(热态 2.7×)、增量重算(改一格 5×)、可选迭代计算、错误解释 API(explain + 依赖图)。真实 Excel 答案键语料 1,001/1,001(100%)(Excel 2024 · 16.0.20527.20196 · zh-CN 生成;2 条奇数参数 IFS 被 Excel 拒绝录入,显式标为子集外),无未归因失败:996 条精确命中 + 4 条 clock-tolerance + 1 条 excel-precision(均在报告披露)。规格语料共 1,171 条(M7 新增 150 条函数规格 + 18 条迭代规格,答案键待桌面 Excel 生成)。2026 MoonBit 年度黑客松 11 月赛参赛项目。
export PATH="$HOME/.moon/bin:$PATH"
# 全量验证:双目标构建 + 88 项单测 + 零 IO 守卫
bash scripts/check.sh
# CLI:求值一个含引用链/错误传播/循环引用的网格
moon build --target native
_build/native/debug/build/cmd/main/main.exe eval --grid tests/fixtures/grid.json
# 跑分:真实 Excel 权威语料(默认 corpus/cases)
bash scripts/run-bench.sh
# 性能基准:进程内大网格重算(默认 1 万格,见 docs/performance.md)
moon build --target native --release
_build/native/release/build/cmd/main/main.exe perf --cells 100000
# 浏览器 playground(wasm-gc):支持 CSV 拖拽/按钮导入(行主序,=公式格可直接算)
bash scripts/build-playground.sh
(cd playground && python3 -m http.server 8080) # 打开 http://localhost:8080/
# headless Chromium 冒烟(20 断言,零 npm 依赖)
node scripts/smoke.mjsexport PATH="$HOME/.moon/bin:$PATH"
moon run examples/xlsx-demo --target native -- gen # 生成 fixture _build/xlsx-demo/input.xlsx
moon run examples/xlsx-demo --target native -- run # 读→算→写 output.xlsx,并读回断言
# xlsx-demo verification PASS: 39/39 (formula + cached value + literal checks)moon add buguoshixc/mooncalcimport {
"buguoshixc/mooncalc" @mooncalc,
}fn main {
let grid = @mooncalc.new_grid()
grid.cells["A1"] = @mooncalc.Cell::Literal(@mooncalc.Value::Num(6.0))
grid.cells["B1"] = @mooncalc.Cell::Formula("=A1*7")
// now: None 时 TODAY/NOW 按契约返回 #NUM!;需要时钟时传入 Excel 序列日。
let out = @mooncalc.recalc(grid, { now: None })
match out.cells.get("B1") {
Some(r) => println(r.value) // Num(42)
None => println("missing")
}
}| 层 | 数字 | 性质 |
|---|---|---|
| 单元/快照测试 | 88/88 | 手写期望(引擎语义回归 + codec + 语法 + bench 桶 + 限制边界 + 确定性 fuzz) |
| 过渡语料 bench | 34/34(100%) | source: manual,非权威,仅证明流程 |
| 用例规格 | 1,003 条(corpus/spec/,每函数 ≥15) | 1,001 条已生成权威答案键;2 条奇数参数 IFS 被 Excel 拒绝录入(子集外,不进入分母) |
| 真实 Excel 语料 | 1,001/1,001(100%) | Excel 2024 为唯一裁判;996 match + 4 clock-tolerance + 1 excel-precision,0 条未归因失败,见 corpus/reports/real.json |
| 族 | 函数 |
|---|---|
| 逻辑 | IF、IFS、SWITCH、AND、OR、NOT、IFERROR、XOR |
| 文本 | LEFT、RIGHT、MID、LEN、TRIM、UPPER、LOWER、CONCAT、TEXTJOIN、TEXT、VALUE、FIND、SUBSTITUTE、REPLACE、SEARCH、PROPER |
| 数学 | ROUND、ROUNDUP、ROUNDDOWN、ABS、INT、MOD、POWER、SQRT、SUM、SUMIF、SUMPRODUCT、CEILING、FLOOR |
| 统计 | AVERAGE、COUNT、COUNTA、COUNTIF、MIN、MAX、MEDIAN、STDEV、VAR、PERCENTILE |
| 查找 | VLOOKUP、XLOOKUP、HLOOKUP、INDEX、MATCH、CHOOSE |
| 日期 | DATE、EOMONTH、YEAR、MONTH、DAY、TODAY、NOW |
_build/native/debug/build/cmd/main/main.exe bench --corpus corpus/cases --report corpus/reports/real.jsonfn eval_formula(formula : String, grid : Grid, options : EvalOptions) -> Result[EvalOutput, ParseError]fn eval_formula_iterative(formula : String, grid : Grid, options : EvalOptions, iter : IterOptions) -> Result[EvalOutput, ParseError]fn recalc_update(state : RecalcState, grid : Grid, changed : Array[String], options : EvalOptions) -> RecalcOutputInstall
Download zipExcel-compatible spreadsheet formula engine in MoonBit