Go Excelize 读取公式单元格时为什么拿到旧结果

用 Go Excelize 读取公式单元格拿到旧结果，最常见的原因不是公式突然失效，而是把工作簿里保存的缓存值当成了重新计算结果。GetCellValue 适合读取单元格当前保存并按格式转换后的值；需要在 Go 进程里重新计算时，应显式调用 CalcCellValue，并检查它是否支持公式涉及的函数和引用。

官方地址：https://github.com/xuri/excelize/

排查顺序是：先用 GetCellFormula 确认公式，再同时读取 GetCellValue 和 CalcCellValue。前者旧、后者新时，问题在缓存；两者都不对时，再检查输入、引用或计算能力。

先确认读到的是公式，不是普通值

Excel 文件通常同时保存公式文本和上次计算后的结果。导出程序、第三方表格工具或用户手工修改输入后，缓存可能还没有刷新。第一步不要只打印一个值，而是把公式、读取值和计算值放在一起观察。

package main

import (
    "fmt"
    "log"

    "github.com/xuri/excelize/v2"
)

func main() {
    f, err := excelize.OpenFile("report.xlsx")
    if err != nil {
        log.Fatal(err)
    }
    defer f.Close() // 读取结束后释放工作簿资源

    formula, err := f.GetCellFormula("Sheet1", "C2")
    if err != nil {
        log.Fatal(err)
    }
    cached, err := f.GetCellValue("Sheet1", "C2")
    if err != nil {
        log.Fatal(err)
    }
    calculated, err := f.CalcCellValue("Sheet1", "C2")
    if err != nil {
        log.Fatal(err) // 计算失败时保留错误，不把空字符串当成结果
    }
    fmt.Printf("formula=%s cached=%s calculated=%s\n", formula, cached, calculated)
}

如果 formula 非空，且 cached 与 calculated 不同，先不要改公式。这个差异说明文件里的保存值与本次计算路径不一致，常见于输入单元格刚被改过但没有经过表格引擎重算。

用 CalcCellValue 获取当前计算结果

CalcCellValue 返回的是 Excelize 计算器根据当前工作簿内容得到的值；它不会把“读取缓存”这个动作自动升级为重算。对需要实时导出、接口返回或校验的场景，建议把它作为业务结果，把 GetCellValue 作为展示值或对照值。

还要注意格式差异：GetCellValue 会尝试应用单元格格式，返回字符串；排查数值时可把公式结果和原始输入一起记录，避免把日期、百分比或小数位变化误判为缓存问题。

输入变更后，先写完再计算

如果程序先修改了参与公式的输入，又立刻读取旧值，应该把写入、计算、错误处理放在同一条路径中。下面的例子只关心计算结果，不依赖重新打开文件。

// updateTotal 修改输入后立即计算总额，避免继续使用旧的工作簿缓存。
func updateTotal(f *excelize.File, sheet string, amount float64) (string, error) {
    if err := f.SetCellValue(sheet, "B2", amount); err != nil {
        return "", err
    }
    // C2 的公式应已存在，例如 =B2*1.13；这里读取当前计算结果。
    value, err := f.CalcCellValue(sheet, "C2")
    if err != nil {
        return "", fmt.Errorf("calculate %s!C2: %w", sheet, err)
    }
    return value, nil
}

如果目标是生成一个交给 Excel 或 WPS 打开的文件，还要把“由哪个引擎负责最终重算”说清楚：Excelize 可以在内存中计算一部分公式，但并不等同于完整的 Office 计算引擎。遇到外部链接、宏、自定义函数或未覆盖的函数时，应让兼容的表格软件打开并保存，或在业务侧明确提示结果需要刷新。

两种结果都不对时检查这四个边界

• 输入是否真的变了：把参与公式的 A1、B1 等输入单元格单独读出，确认没有写错工作表或坐标。
• 公式是否仍在目标格：用 GetCellFormula 读取，排除公式被普通值覆盖、共享公式范围变化等情况。
• 引用是否可计算：跨表引用、外部工作簿、名称区域和部分高级函数可能需要真实表格引擎。
• 显示值是否被格式影响：百分比、日期和小数位只改变字符串呈现，不代表底层计算结果相同。

把这四项记录到日志后再决定是否替换公式，通常比直接把 GetCellValue 改成另一个读取 API 更稳。

常见追问

为什么公式存在但 GetCellValue 为空？可能只有公式文本而没有可用的保存结果，也可能公式依赖的计算由 Office 延后完成。先看 GetCellFormula，再尝试 CalcCellValue。

CalcCellValue 能保证和 Excel 一致吗？不能对所有 Excel 能力作这种保证。简单算术和常见函数通常更适合在库内计算；复杂引用、外部数据或特殊函数要安排 Office/WPS 重新计算的验收路径。