Go huh 表单结束后为什么变量值仍未更新

用 huh 做终端表单时，最容易误判的一件事是：屏幕上明明输入了新内容，form.Run() 返回后，代码打印出来的变量却还是旧值。大多数情况下，问题不在表单没有接收到输入，而在字段绑定到了副本、读取时碰到了变量遮蔽，或者表单其实没有进入完成状态。

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

先看绑定目标：当前的 huh API 通过 Value(&变量) 保存一个指针访问器，字段更新时会把值写回这个地址。表单结束后只在 Run() 没有报错、状态确实完成时读取结果；如果使用了 Key，也可以从完成的 Form 取值。

先确认 Value 绑定的是原变量地址

官方仓库的使用方式很直接：先声明保存答案的变量，再把变量地址传给字段的 Value。当前源码中，Input.Value 接收 *string，Select.Value 接收对应类型的指针；字段内部通过指针访问器读取和设置这个目标。

package main

import (
	"fmt"
	"log"

	"charm.land/huh/v2"
)

func askName() string {
	name := "未填写"

	form := huh.NewForm(
		huh.NewGroup(
			huh.NewInput().
				Title("你的名字").
				Value(&name), // 传入地址，让字段直接写回 name。
		),
	)

	if err := form.Run(); err != nil {
		log.Printf("表单未完成：%v", err) // 中止或输入错误时不要读取为已提交结果。
		return ""
	}

	fmt.Println("提交后的值：", name) // 正常完成后读取同一个变量。
	return name
}

这里的重点不是把 &name 当成固定语法，而是确保表单字段拿到的地址就是最终要读取的变量。若在调用 Value 之前复制了一份字符串，huh 写回的是副本，原变量当然不会变化。

副本绑定会让原变量看起来没有更新

下面的代码能正常完成表单，但字段绑定的是 draft。如果后面打印的是 name，读到旧值是符合代码含义的，不是 huh 丢失了输入。

func wrongBinding() (string, error) {
	name := "旧值"
	draft := name // 这里创建了一个独立字符串变量。

	form := huh.NewForm(
		huh.NewGroup(
			huh.NewInput().
				Title("名称").
				Value(&draft), // huh 写入 draft，不会写回 name。
		),
	)
	if err := form.Run(); err != nil {
		return "", err // 表单未完成时不返回未确认的名称。
	}
	return name, nil // 这里仍然是旧值；要么返回 draft，要么绑定 &name。
}

排查时可以沿着一条线看：字段的 Value 参数是谁、Run 返回后读取的是谁、两者是否只是同一内容的两个变量。字符串、整数、布尔值都会遇到同样的绑定边界。

变量遮蔽也会把正确结果藏起来

另一种常见情况是外层变量已经绑定正确，但处理结果时使用了 := 创建同名局部变量。这个局部变量只在当前代码块存在，离开代码块后打印外层变量，看到的仍然是旧值。

func shadowedValue() (string, error) {
	name := "旧值"
	form := huh.NewForm(
		huh.NewGroup(
			huh.NewInput().Title("名称").Value(&name), // 绑定外层 name。
		),
	)
	if err := form.Run(); err != nil {
		return "", err
	}

	if true {
		name := name // 新变量遮蔽外层 name，左侧不会改变外层变量。
		_ = name     // 这里只是演示作用域，不要用同名副本承接结果。
	}
	return name, nil // 读取的是最初绑定的外层变量。
}

修复方式很朴素：已经声明过的变量用 =，需要新变量时换一个能表达用途的名字，例如 submittedName。不要通过改变量名来掩盖真正的绑定关系，先把“写入目标”和“读取目标”对上。

检查 Run 返回值和表单状态

Run() 的返回值必须先处理。用户中止、校验不通过或其他运行错误都不应该继续走“提交成功”分支。官方源码把表单状态分为正常、完成和中止；只有完成状态才适合把答案交给后续业务。

func collect() (string, error) {
	name := ""
	form := huh.NewForm(
		huh.NewGroup(
			huh.NewInput().Title("名称").Value(&name), // 目标仍然是外层 name。
		),
	)

	if err := form.Run(); err != nil {
		return "", fmt.Errorf("collect form: %w", err) // 保留中止或运行错误。
	}
	if form.State != huh.StateCompleted {
		return "", fmt.Errorf("form did not complete: %v", form.State) // 不把未完成状态当提交。
	}
	return name, nil
}

如果你只看到“值没有更新”，先确认程序有没有因为错误提前返回。即使字段曾经显示过输入，用户按取消键或校验失败时，也不能把内存中的暂存值当成已经提交的业务结果。

多字段场景可以用 Key 读取结果

直接指针绑定适合小型表单；当表单被封装在 Bubble Tea 模型里，或者你希望字段与读取逻辑解耦，可以给字段设置 Key。表单完成后再读取对应类型的值，避免到处传递同一个变量。

func collectWithKey() (string, error) {
	form := huh.NewForm(
		huh.NewGroup(
			huh.NewInput().
				Key("name").
				Title("名称"), // 结果放在 form 的键值结果中。
		),
	)
	if err := form.Run(); err != nil {
		return "", err // 先处理取消或其他错误。
	}
	if form.State != huh.StateCompleted {
		return "", fmt.Errorf("form is not completed") // 完成边界仍然要判断。
	}
	return form.GetString("name"), nil // Key 与读取类型必须对应。
}

在 Bubble Tea 集成中，官方示例把 huh.Form 当作模型更新，并在完成状态读取 GetString、GetInt 等结果。若你的模型持有指针字段，还要把 Update 返回的模型重新保存到模型结构中，不能只调用而忽略返回值。

一份收敛后的排查清单

1. 查看 Value 是否传入了目标变量的地址，而不是副本地址。
2. 对照 Value 的绑定目标和 Run 后的读取目标，确认不是两个同值变量。
3. 搜索同一作用域里的 :=，排除同名变量遮蔽。
4. 先判断 Run() 的错误，再判断 form.State == huh.StateCompleted。
5. 需要解耦时使用稳定的 Key，并用对应的 GetString、GetInt 或其他读取方法。

几个容易混淆的问题

Value 为什么一定要传指针？

因为字段需要在交互过程中持续写回外部保存位置。传入指针后，huh 的访问器能够读取初始值，也能把用户输入设置回同一个变量。

表单退出后变量不变，是不是必须手动 GetValue？

不一定。使用 Value(&name) 时，正常完成后直接读取 name 即可；使用 Key 时才从 Form 读取键值结果。先确认绑定方式和完成状态，比盲目增加读取调用更重要。

用户取消后还能使用变量里的旧值吗？

可以把它当作默认值或草稿，但不能当作这次表单已经提交的新结果。把取消和完成分支分开，后续逻辑会更容易维护。

归根结底，huh 表单结束后的旧值问题通常是 Go 的数据绑定和作用域问题：字段写到了哪里，代码就应该从哪里读；Run 没有成功完成，就不要把暂存状态包装成提交结果。