Go Excelize 怎么给单元格添加下拉数据校验

Go Excelize 给单元格添加下拉数据校验，核心是创建 DataValidation，用 SetSqref 指定可填写区域，用 SetDropList 设置候选，再把规则交给 AddDataValidation 绑定到工作表。仅把候选文字写进单元格，并不会自动生成下拉规则。我更愿意先把“在哪里选”和“可以选什么”分开，再处理保存与输入提示，这样排查时不容易把两种范围弄反。

官方地址：https://xuri.me/excelize/

状态列有文字，为什么还不是下拉列表

设想一份工单填写模板，B1 是“工单状态”，B2:B30 留给使用者选择“待处理、处理中、已完成”。第一次写模板时，很容易只在 B2 写入“待处理”，以为 Excel 会顺带把它变成选择项。实际上单元格值与数据校验规则是两类对象：值负责当前内容，规则负责允许选择的集合。

我会把这个场景缩小到一张表、一列与三个候选，不急着加入样式、合并单元格或跨表字典。先确保规则的对象关系明确，再讨论模板外观。下面是原创示例及读者可执行的观察步骤，不是已在本机跑通的结果记录。

把 B2:B30 和三个状态分开看

SetSqref 负责规则覆盖哪里，SetDropList 负责允许哪些选项，AddDataValidation 的 sheet 参数负责把规则放在哪张表。NewDataValidation 的布尔参数表达是否允许空白，不应把它理解为下拉开关。

先生成一个能解释清楚的小文件

示例固定 Excelize v2.9.1，采用模块 github.com/xuri/excelize/v2。该版本的 go.mod 声明 Go 1.23.0；选择满足要求的 Go 环境。这里固定版本是为了让代码签名明确，不代表推荐所有生产项目直接升级或降级。

# 在独立示例目录初始化，避免改动已有项目的模块声明。
go mod init example.com/ticket-template
go get github.com/xuri/excelize/v2@v2.9.1
# 将完整程序存为 main.go，然后生成模板文件。
go run .

完整程序给第一列增加说明，在 B1 写标题，并为 B2:B30 绑定同一组候选。它不会在每个格子中预填状态；候选列表与单元格当前值保持分离。SaveAs 会写入示例文件，请在独立目录运行，避免覆盖同名重要文件。

package main

import (
    "fmt"
    "log"

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

func buildTemplate() error {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            log.Printf("关闭工作簿失败: %v", err) // 清理错误同样保留记录。
        }
    }()

    const sheet = "Sheet1"
    if err := f.SetCellValue(sheet, "A1", "工单编号"); err != nil {
        return fmt.Errorf("写入编号标题: %w", err)
    }
    if err := f.SetCellValue(sheet, "B1", "工单状态"); err != nil {
        return fmt.Errorf("写入状态标题: %w", err)
    }

    // true 表示允许空白；目标区域与列表内容分别设置。
    dv := excelize.NewDataValidation(true)
    dv.SetSqref("B2:B30")
    if err := dv.SetDropList([]string{"待处理", "处理中", "已完成"}); err != nil {
        return fmt.Errorf("设置状态候选: %w", err)
    }
    dv.SetInput("选择状态", "请从列表中选择工单状态")
    dv.SetError(excelize.DataValidationErrorStyleStop,
        "状态不在列表中", "请选择待处理、处理中或已完成")
    if err := f.AddDataValidation(sheet, dv); err != nil {
        return fmt.Errorf("绑定数据校验: %w", err)
    }
    // 在独立示例目录保存；生产接入时应自行管理输出名称。
    if err := f.SaveAs("ticket-template.xlsx"); err != nil {
        return fmt.Errorf("保存模板: %w", err)
    }
    return nil
}

func main() {
    if err := buildTemplate(); err != nil {
        log.Fatal(err) // 不将失败文件当成成功交付。
    }
    fmt.Println("模板已保存：ticket-template.xlsx")
}

我倾向于把错误包装得接近操作含义：列表设置出错与保存失败不应该给调用方同一个模糊消息。尤其不能忽略 SetDropList 的返回值，之后仅根据 SaveAs 没报错来判断候选规则一定符合意图。

没有看到选择项时，先定位规则在哪

先选中 B2，而不是 B1 或 B31；标题行和范围外的单元格并没有被覆盖。再确认打开的是刚保存的文件、正在查看的确实是 Sheet1。接着回到代码，查是否只创建了 dv 却没有 AddDataValidation，或保存的是另一份 File 实例。这些差异比“是不是要多设一个开关”更值得先确认。

还要区分看不到候选与候选内容错误。前者可能是目标区域或表名不一致；后者应看实际传给 SetDropList 的字符串切片。候选使用明确、短小的标签较容易维护。如果选项包含逗号，或者列表总长度增长，就不要继续把复杂字典压进内嵌列表字符串。

官方文档说明内嵌列表有包含分隔符在内的长度限制，超出时应改用单元格引用。本文无需用长列表演示这个上限；更重要的是把字典变大与目标区域扩大区分开：B2:B30 改为 B2:B300，不会自动增加候选种类。

字典变大后，把候选放进 E2:E4

对需要维护候选字典的模板，我会选单元格来源。仍使用 Sheet1，E2:E4 作为字典，B2:B30 作为填写区；绝对引用可以直观表达候选区域固定。下面片段用于替换完整程序中的候选规则构造部分，不要与原规则一起重复绑定到同一目标区域。

// 片段位于 buildTemplate 中，使用已有的 f 和 sheet。
options := []string{"待处理", "处理中", "已完成"}
for i, text := range options {
    cell := fmt.Sprintf("E%d", i+2)
    if err := f.SetCellValue(sheet, cell, text); err != nil {
        return fmt.Errorf("写入候选字典 %s: %w", cell, err)
    }
}
dv := excelize.NewDataValidation(true)
dv.SetSqref("B2:B30") // 目标填写区，不是字典区。
dv.SetSqrefDropList("$E$2:$E$4") // 来源引用固定在同一工作表。
dv.SetError(excelize.DataValidationErrorStyleStop,
    "请选择列表项", "当前值不属于候选字典")
if err := f.AddDataValidation(sheet, dv); err != nil {
    return fmt.Errorf("绑定引用型列表: %w", err)
}
// 后续继续使用完整程序中的 SaveAs 保存。

这种方式的代价是工作簿多了一块字典区域，模板维护者需要知道它的用途。不要把业务说明或空白行混进引用范围。跨工作表和级联候选另有公式及兼容性问题，本例不把同表写法直接推广过去。

打开模板后，应该观察什么

读者可以在目标 Excel 客户端中打开示例文件，选中 B2 和 B30 看是否具有预期候选；再选中 B31，区分范围边界。输入一个列表内标签，随后尝试直接键入列表外标签，观察是否出现设置的 Stop 提示。允许空白是本例的明确选择，不应把空白被保留当成异常。

这些是预期检查点，不是作者已经执行的结果。不同客户端的呈现需要在实际使用环境观察；模板输入规则也不能替代后端导入时的业务判断。导入服务仍应按允许集合判断状态，因为服务不能假设所有文件都是由这份模板填写得到的。

我会在哪些模板中采用它

候选少、变化慢、名称简单时，内嵌列表更紧凑；候选由模板维护者调整或包含复杂文本时，单元格来源更清楚。两者都要保持目标区域、候选来源与错误提示的职责分离。对于工单状态这样的固定枚举，下拉规则的价值主要是减少手工拼写差异，而不是建立新的业务授权机制。

NewDataValidation(true) 是显示下拉的意思吗？

不是，它指定允许空白。列表规则由 SetDropList 或 SetSqrefDropList 设置，并需要绑定到工作表。

给 B2 设置规则，会自动覆盖整列吗？

不会，本例明确写 B2:B30。覆盖哪些格子由目标引用决定，不由候选数量决定。

列表显示了，为什么仍要在导入端判断状态？

模板面向填写体验，导入端面对的是实际文件数据。两者各自负责，后端只接受业务允许的值。

参考：官方数据校验文档、v2.9.1 数据校验 API 实现与该版本模块要求。