Go tview 新增输入组件后为什么键盘焦点没切换

在 Go tview 中，动态新增输入组件后键盘焦点没有切换，通常不是输入框没有加入布局，而是“可见”和“当前焦点”本来就是两件事。Flex.AddItem 会把组件放进容器的项目列表，但如果容器当前已经把焦点交给旧组件，新增动作不会自动把焦点抢过来。修复方式很直接：新增完成后调用 Application.SetFocus(newInput)，让焦点链显式落到新输入框。

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

先看事件到底送给谁，再看输入框是否画出来。tview 的按键会沿当前焦点链转发；新组件即使已经显示，只要还没有进入这条链，就不会收到键盘输入。

• AddItem 解决的是“组件属于哪个布局”的问题。
• SetFocus 解决的是“后续键盘事件交给哪个 Primitive”的问题。
• focus=true 只在 Flex 自己重新获得焦点时参与默认选择，不等于动态添加后立即切换。
• 后台 goroutine 修改 tview 组件时，应通过 QueueUpdateDraw 串行更新并重绘。

先区分显示、加入布局和获得焦点

这个问题常见于“新增一行搜索条件”“点击按钮后插入一个编辑框”或“切换页面后追加输入项”。排查时可以把状态拆成三层：

前两层正常而第三层失败时，输入框通常能看见，却对字母、退格和回车没有反应。原因是 Application 的事件循环只会把按键交给当前根组件的焦点链；它不会根据“最后新增的组件”自动猜测用户想编辑哪一个。

检查容器的焦点委托规则

tview 的 Primitive 接口把焦点分成了两个动作：容器的 Focus 可以通过回调把焦点委托给子组件，Application.SetFocus 则负责先让旧焦点失焦，再沿新组件的父级链建立焦点。Flex.AddItem 的第四个参数表示该项目在 Flex 重新获得焦点时是否优先，但它本身只追加项目，不执行一次全局焦点迁移。

因此，下面这种写法会留下一个容易忽略的状态：新输入框出现在界面上，但旧输入框仍然持有焦点。

func addInputOnly(flex *tview.Flex) *tview.InputField {
	// AddItem 只改变布局项目列表，不主动改变 Application 的当前焦点。
	newInput := tview.NewInputField().SetLabel("新条件：")
	flex.AddItem(newInput, 1, 0, false)
	return newInput
}

如果把第四个参数改成 true，也不要把它理解成“现在马上聚焦”。它表达的是：当 Flex.Focus 下一次被调用时，优先把焦点委托给这个项目。当前焦点仍在旧输入框时，单独追加项目不会触发这次重新委托。

用 Application.SetFocus 切换到新输入框

最小修复就是保留新输入框的指针，在加入容器后显式调用 SetFocus。这个调用会让旧组件执行 Blur，再让新组件和它的父级收到 Focus；InputField.Focus 还会继续把焦点委托给内部的文本区域，所以后续按键可以真正落到输入位置。

func addAndFocus(app *tview.Application, flex *tview.Flex) {
	// 新组件需要先加入布局，随后再把它设置为应用当前焦点。
	newInput := tview.NewInputField().SetLabel("新条件：")
	flex.AddItem(newInput, 1, 0, false)
	app.SetFocus(newInput)
}

如果这段逻辑是在当前按键回调中执行，直接调用通常就够了。调用完成后可以用 app.GetFocus() 做调试观察；文章中的生产代码不需要把这个检查永久保留。

按调用线程选择直接更新或排队更新

tview 的 Primitive 不是让多个 goroutine 随意同时修改的对象。按钮回调、键盘回调本来就在应用事件循环中，可以直接更新；网络请求、定时器或后台任务完成后，则把新增组件和焦点切换放进 QueueUpdateDraw，让更新和重绘在同一条串行路径里完成。

func addFromWorker(app *tview.Application, flex *tview.Flex) {
	// 后台任务不能直接并发改布局，交给 tview 事件循环统一执行。
	app.QueueUpdateDraw(func() {
		newInput := tview.NewInputField().SetLabel("异步条件：")
		flex.AddItem(newInput, 1, 0, false)
		// 回调结束前设置焦点，重绘时光标就会落到新输入框。
		app.SetFocus(newInput)
	})
}

这里有两个容易混淆的点。第一，QueueUpdateDraw 不会替你选择焦点，仍然要显式调用 SetFocus。第二，如果已经在 tview 的主事件回调中，就不要再用一个会等待自身执行完成的排队调用包住同一段逻辑，否则可能形成不必要的等待。

排查 Form、Pages 和已禁用组件的边界

如果你使用的不是单独的 Flex，还要检查容器自己的焦点规则：

• Pages 只会把焦点委托给可见页面。新页面即使已经 AddPage，仍需切换到它或直接把焦点设给页面里的输入组件。
• Form 会在重新获得焦点时按当前焦点或 requestedFocus 选择未禁用项目。动态加入后，如果焦点仍在原项目，不能只期待表单自动重排。
• 被 SetDisabled(true) 的表单项不能成为可操作焦点；如果你显式设置到错误的项目，表面上看起来就像焦点没有切换。
• InputField 的可见外壳和内部 TextArea 是一层委托关系，通常应把焦点设置给 *InputField，让组件自己完成内部委托。

可以把问题压缩成一句判断：如果组件能画出来但 app.GetFocus() 仍指向旧组件，修复焦点链；如果焦点已经指向新组件却仍不能输入，再检查它是否被禁用、是否被自定义输入处理器拦截，以及更新是否发生在正确的事件线程。

结论

Go tview 新增输入组件后键盘焦点没切换，核心原因通常是 AddItem 只完成了布局注册，没有替当前应用重新建立焦点链。把新组件保存下来，在主事件回调中直接调用 app.SetFocus(newInput)；后台 goroutine 则使用 QueueUpdateDraw 包住“加入布局、设置焦点、重绘”这一组操作。使用 Flex 的 focus=true 只能影响容器下一次获得焦点时的默认选择，不能替代这次显式切换。

常见问题

把 AddItem 的 focus 参数设为 true 后仍不切换，为什么？

因为这个参数是 Flex 重新获得焦点时的委托偏好。动态追加项目不会自动调用一次 Application.SetFocus，所以当前焦点仍可能留在旧输入框。

应该把焦点设置给 InputField 还是内部 TextArea？

通常设置给 *tview.InputField 即可。InputField 的 Focus 会把焦点继续委托给内部文本区域，直接依赖内部对象会让代码耦合到组件实现。

新增组件后界面不刷新，是不是焦点问题？

不一定。后台 goroutine 中直接改组件可能同时带来并发和重绘问题。先用 QueueUpdateDraw 串行完成更新；如果组件已经显示但不能输入，再单独检查焦点。

Pages 切换后新页面里的输入框仍没有焦点怎么办？

确保页面是可见的，再把焦点设置到页面内的目标输入组件，或让页面容器在重新获得焦点时正确委托。只调用 AddPage 不等于用户已经进入该页面的输入区域。