Go huh 怎么让选择项显示标签却保存业务值

Go huh 的选择项可以显示中文标签，同时保存稳定业务编码：用 huh.NewOption("内部预览", "preview") 配对标签和值，再用 NewSelect[string] 和 Value(&channel) 绑定接收变量。用户阅读标签，脚本使用编码，不需要从中文反向解析。

官方地址：https://github.com/charmbracelet/huh

下面以发布渠道选择器为例，只输出选择，不执行发布。示例采用官方当前 README 的 charm.land/huh/v2 导入路径；旧项目以自身 go.mod 为准，不混用主版本。

把标签与业务编码成对定义

“内部预览”对应 preview，“公开发布”对应 public。标签服务于阅读，编码服务于配置与接口；不要把选项列表里的位置当成持久化 ID。NewOption 的第一参数是字符串标签，第二参数是业务值。官方 Option 分别保存 Key 和 Value，Key 在这里并不是数据库主键。

绑定接收变量并处理表单错误

在空目录创建 main.go。channel 默认值设为列表中已经存在的 preview；表单完成前不调用下游，避免把编辑选择误认为任务提交。

package main

import (
    "fmt"
    "os"
    "charm.land/huh/v2"
)

func main() {
    // 接收变量保存编码，中文标签只负责展示。
    channel := "preview"
    form := huh.NewForm(
        huh.NewGroup(
            huh.NewSelect[string]().
                Title("选择发布渠道").
                Options(
                    huh.NewOption("内部预览", "preview"),
                    huh.NewOption("公开发布", "public"),
                ).
                Value(&channel),
        ),
    )
    // 中断或错误时停止，不消费可能已发生变化的变量。
    if err := form.Run(); err != nil {
        fmt.Fprintln(os.Stderr, "选择未完成：", err)
        os.Exit(1)
    }
    // 只接受应用明确支持的编码，此处不执行实际发布。
    switch channel {
    case "preview", "public":
        fmt.Printf("channel=%s\n", channel)
    default:
        fmt.Fprintln(os.Stderr, "不支持的渠道编码")
        os.Exit(1)
    }
}

# 在示例目录初始化模块，安装同一主版本依赖。
go mod init example.local/channel-picker
go get charm.land/huh/v2
# 运行交互选择示例，不会调用发布接口。
go run .

安装后保留 go.mod 和 go.sum，团队使用同一依赖集。官方主分支 go.mod 当前声明 Go 1.25.8；实际安装版本的工具链要求以其 go.mod 为准。本文示例未在本机执行，不将预期输出当作实测结果。

按这份映射选择“公开发布”，预期打印 channel=public，而不是中文标签。若拿到标签，先看 NewOption 的第二参数是否误填了中文；若编译报类型不一致，看 Select 泛型、选项值和接收指针是否使用同一种类型。

表单成功后再把值交给任务层

Value 绑定变量地址。把表单编辑与任务提交拆成两个边界：Run 成功后才消费 channel；返回错误时直接停止，不在错误分支继续提交。即便菜单里出现“公开发布”，它也不代表账号获得授权，真正的服务端权限仍由业务系统独立判断。

不要监听变量变化就自动执行任务；用户可能还在编辑，也可能中断表单。实际接入脚本时，只在成功分支创建任务参数，并按现有业务规则保留确认、权限判断与下游错误处理。这里的代码仅输出编码，不包含发布凭据或网络调用。

如果业务使用整数 ID，选择 NewSelect[int]，NewOption 第二参数使用 int，接收变量也使用 int。int64 不能直接作为 int 指针；需要统一类型，而不是通过中文标签绕一圈转换。

标签改动与选项数据的边界

能直接用 NewOptions 吗？它从值生成展示文本，适合标签就是值的情况。需要中文名称与编码不同，逐项 NewOption 更清楚。业务表记录可转换成 Option：名称作为标签，ID 作为值。

改标签会不会改业务值？保留第二参数就不会。更换中文提示通常只需要改第一参数；删除或重命名编码则影响已有配置，应该作为数据契约变更处理，不是单纯文案调整。

重复标签和重复值有什么区别？同名标签使用户难以分辨，重复编码使下游无法区分对象。应用自己的选项数据应明确一一对应，标签可加必要说明，编码保持唯一。不要指望组件替你消除业务模型歧义。

默认值应该填什么？填选项列表中实际存在的业务值，例如 preview，而不是“内部预览”。不要依赖一个没有列出的编码继续提交。

速查：NewOption 配对标签和值，Select 泛型固定值类型，Value 绑定同类型变量。表单成功后才消费值，错误时停止，权限独立判断。这样既能保留中文可读性，也能让下游配置免受提示文案变化影响。

参考：官方 README、Option 定义、Select 绑定实现、主分支模块要求。