Go tview 怎么用 Form 收集多种输入字段

我第一次用 tview 写终端配置页时，最容易写乱的地方不是布局，而是“一个表单里有好几种输入，最后到底从哪里取值”。比较稳的做法是让 tview.Form 只负责组合字段和处理焦点，让每个字段的回调同步到一个 Go 结构体，保存按钮只读取这个结构体。

官方资料地址：https://github.com/rivo/tview

本文只处理一个具体任务：用 Form 收集文本、下拉选择、复选框和多行备注。tview 是终端 UI 组件库，Form 支持这些表单元素，并且可以把按钮动作和 Enter、Escape 的表单级行为分开配置。

先把多种字段映射到一个状态对象

我会先定义最终要保存的数据，而不是先堆控件。这样做的好处是：字段类型一变，回调的责任仍然清楚；保存时也不需要再反过来从 Form 的内部索引读取值。

这个例子假设终端配置页需要项目名、运行环境、是否开启日志和一段备注。四类字段分别对应字符串、下拉选择、布尔值和多行文本。

图中的关键不是控件数量，而是“字段回调”这一层。控件只报告变化，profile 才是提交时真正读取的输入快照。

用 Add 方法组装一张可提交的 Form

Form 的组合方式很直接：文本用 AddInputField，枚举选择用 AddDropDown，开关用 AddCheckbox，较长内容用 AddTextArea，最后用 AddButton 暴露保存和取消动作。

下面的完整片段刻意把业务状态放在 profile 里。changed、selected 回调只做轻量赋值；保存动作再统一处理必填项。

package main

import (
    "fmt"
    "log"
    "strings"

    "github.com/rivo/tview"
)

type profile struct {
    Name        string
    Environment string
    Logging     bool
    Note        string
}

func main() {
    var data profile

    form := tview.NewForm().
        AddInputField("项目名", "", 24,
            func(text string, lastChar rune) bool {
                // 用待接受文本限制长度，避免项目名超过终端布局。
                return len([]rune(text)) 

这里有两个容易忽略的取舍。第一，AddDropDown 的初始索引使用负数时可以保留“尚未选择”的状态；第二，Form 会把非按钮字段按添加顺序组织起来，业务代码不需要依赖内部索引。

把回调设计成轻量的字段同步

表单字段的回调会在用户输入或选择变化时触发，所以适合做内存状态同步，不适合直接写文件、访问网络或启动长时间计算。否则用户每输入一个字符，都可能被慢操作拖住。

一个实用边界是：changed 只更新字符串，selected 只更新选择结果，AddButton 和 SetSubmitFunc 才进入保存流程。这样保存逻辑只有一个入口，后面换成配置文件、数据库或 API 时不必修改每个字段回调。

如果需要根据一个字段动态改变另一个字段，也建议先更新状态，再把必要的 UI 更新放到应用的更新机制中；不要在回调里层层调用保存，避免一次选择触发多次提交。

让焦点、Enter 和 Escape 各司其职

终端表单的“可用”不只是字段能显示，还包括用户能否只用键盘完成一次编辑。Form 自己管理字段之间的焦点移动；字段回调不需要接管 Tab、Enter 或 Escape。

我通常把 Enter 绑定到和“保存”按钮相同的函数，把 Escape 绑定到取消函数。这样鼠标、按钮和键盘只是不同入口，最终都进入同一个业务动作。对于多行文本区域，则要特别注意不要把 Enter 当成无条件提交键，否则用户还没有写完备注就会离开字段。

性能检查：不要在按键回调里做慢工作

tview 的输入体验适合轻量状态更新。文件落盘、网络请求、密码校验、远端查询等工作放到提交后执行；如果必须执行耗时任务，再把结果通过应用的更新机制送回界面。

多行内容还要设置合理的最大长度。AddTextArea 的最大长度参数为零时表示不限制，配置备注这类字段通常不需要无限增长。长度限制应该服务于实际存储边界，而不是随便填一个很小的数字。

另一个小经验是不要为了“实时预览”在每个字符变化时重新构建整张 Form。控件创建属于结构初始化，字段回调属于状态变化；把两者分开，界面行为更稳定。

空值、取消和重复提交怎么处理

多种输入字段组合后，最常见的边界状态有四个：

• 项目名为空：在保存边界拒绝提交，并保留用户已填写的其它字段。
• 下拉框未选择：使用空字符串表示未完成，不要把第一个选项偷偷当成用户选择。
• 用户按 Escape：只退出编辑，不把当前半成品写入持久化存储。
• 用户连续按保存：保存动作需要具备幂等性，或者在保存期间禁用按钮。

这几个判断都属于业务层，不需要修改 tview 的 FormItem。若要按标签找到字段，可以使用 Form 提供的按标签查询能力；如果只是收集结果，直接维护结构体通常更简单，也更不容易把控件顺序和业务字段绑定在一起。

最后的选择：什么时候适合用 tview.Form

如果你的终端页面是“若干字段 + 少量按钮 + 一次提交”，Form 很合适：控件组合集中，焦点移动有统一规则，字段回调也足够表达收集过程。对复杂的多页向导、强依赖异步数据的编辑器，最好把状态机和页面切换单独建模，再把每一页需要的字段交给 Form。

我自己的落点是：先定义结果结构体，再添加字段；回调只同步，提交才校验；Enter 和按钮共用保存函数，Escape 明确放弃当前编辑。这样既能收集多种输入，也不会让终端 UI 代码变成一团互相调用的回调。

相关问题

tview 的下拉框怎么表示“还没有选择”

给 AddDropDown 的初始选项传负数，回调只在用户选择后更新状态，提交时再检查对应字符串是否为空。

字段变化时能不能直接保存配置

可以，但通常不建议。字段变化回调频率高，直接保存会制造大量 I/O；更稳的是先同步内存状态，在保存按钮或明确的自动保存节流点提交。

为什么要同时设置 AddButton 和 SetSubmitFunc

按钮提供可见入口，SetSubmitFunc 提供 Enter 键入口。两者调用同一个保存函数即可保持行为一致。