Go tview Flex 固定宽度和比例宽度有什么区别

在 tview 的 Flex.AddItem 中，fixedSize 和 proportion 不是两种“宽度单位”。前者先锁定当前布局方向上的尺寸，后者只在 fixedSize == 0 时参与剩余空间分配。也就是说，固定尺寸解决“这一块必须占多少”，比例尺寸解决“剩下的空间怎么分”。

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

一句话判断：侧栏、工具栏这类边界明确的区域用固定尺寸；需要跟着窗口伸缩的内容区把 fixedSize 设为 0，再用 proportion 表达相对占比。

先看 AddItem 的两个尺寸参数

典型调用是 AddItem(item, fixedSize, proportion, focus)。这里的尺寸取决于 Flex 的方向：纵向分布时它代表高度，横向分布时它代表宽度。focus 只负责焦点，不改变尺寸计算。

flex := tview.NewFlex().SetDirection(tview.FlexColumn)

// fixedSize=28：纵向分布时锁定 28 行；proportion=0 不参与弹性分配。
flex.AddItem(sidebar, 28, 0, false)

// fixedSize=0：把剩余空间交给比例算法；proportion=2 表示权重为 2。
flex.AddItem(content, 0, 2, true)

对固定项目来说，proportion 会被忽略；对可伸缩项目来说，proportion 至少应为 1。最容易出现的误解是把第二个数字当成“百分比”，实际上它只是相对权重，写 1 和 2 表示按 1:2 分配，不表示 1% 和 2%。

区分固定项目和比例项目

可以把一个终端页面想成三块：左侧导航需要稳定可读，中间正文希望尽量扩大，右侧提示区只需要拿到剩余空间的一部分。这个场景同时使用两种参数，边界就比较清楚。

layout := tview.NewFlex().SetDirection(tview.FlexColumn)

// 导航是固定边界，窗口变窄时仍按这个尺寸占位。
layout.AddItem(nav, 24, 0, true)

// 内容和提示区只瓜分扣除导航后的剩余空间。
layout.AddItem(main, 0, 3, false)
layout.AddItem(help, 0, 1, false)

如果 Flex 的内部高度是 40 行，导航固定占 24 行，剩余空间就是 16 行；正文和提示区的比例总和为 4，因此它们大致得到 12 行和 4 行。这里的“宽度”只是口语，真正的计算方向仍由 FlexColumn 或 FlexRow 决定。

理解比例计算与整数余数

tview 的 Flex 实现会先从可分配空间中扣除所有正的固定尺寸，再统计固定尺寸为 0 的项目的比例总和。比例项目获得的尺寸类似于：

// 这是理解布局的等价公式，不是需要复制的 tview 内部代码。
size = remaining * itemProportion / proportionSum

因此有三个边界需要记住：

• 固定项目先扣除，比例项目不会把固定区域再次算进去。
• 比例是整数权重，不能直接表达小数百分比；需要更细的分配时可以放大权重，例如 25:75 写成 1:3。
• 尺寸计算使用整数，窗口很窄或比例很多时可能出现取整差异；这不是 fixedSize 和 proportion 语义混用，而是终端单元格本身的离散边界。

按界面压力选择参数

不要为了“看起来像一半”而给项目写固定尺寸。固定尺寸适合业务上确实稳定的边界；窗口变化时仍希望两块区域共同伸缩，就应该使用比例。

方向和动态调整的边界

tview 的命名默认与很多 CSS 使用者的直觉相反：FlexColumn 表示沿水平方向排列项目，FlexRow 表示沿垂直方向排列项目；项目文档同时提供了与 CSS 命名一致的常量。选择参数前先确认布局方向，再决定固定的是宽还是高。

// 横向排列：固定尺寸表示宽度，比例项目瓜分剩余宽度。
row := tview.NewFlex().SetDirection(tview.FlexColumn)
row.AddItem(left, 20, 0, false)
row.AddItem(right, 0, 1, true)

// 运行期间需要改布局时，用 ResizeItem 重新设置同一项目的参数。
// fixedSize=0 后，新的 proportion 才会重新参与弹性分配。
row.ResizeItem(right, 0, 2)

ResizeItem 只改布局参数，不替你决定何时刷新界面，也不会把一个固定项目自动转换成比例项目；转换是否发生取决于你传入的 fixedSize。如果修改来自后台 goroutine，还应遵循应用自身的 UI 更新边界，避免并发修改组件状态。

常见误区与最小判断清单

1. 看到 proportion=2 就认为项目固定占两格：错误，它表示相对权重。
2. 给 fixedSize 传 0 却把 proportion 写成 0：该项目没有可分配权重，通常只能得到 0 尺寸。
3. 把 focus=true 当成布局优先级：它只影响焦点委托，不影响宽度或高度。
4. 忽略方向常量：先确定当前尺寸是宽还是高，再解释“固定宽度”。

最终可以按三个问题快速判断：这块区域是否必须锁定？如果不锁定，它是否应该跟随窗口变化？多个弹性区域之间的相对重要性是否能用整数权重表达？三个答案分别对应固定尺寸、比例尺寸和比例值。

相关问题

fixedSize 和 proportion 可以同时设置吗？

可以传入两个值，但只要 fixedSize 大于 0，布局算法就把它当固定项目，proportion 不参与当前计算。

为什么比例项目变窄后出现 0 尺寸？

剩余空间可能已经被固定项目占完，或者窗口尺寸小于比例项目数量与边界所需的离散单元。比例算法不会突破可分配空间。

需要让两个面板永远一半一半怎么办？

把两者的 fixedSize 都设为 0，proportion 都设为 1。这样表达的是相对均分，窗口变大或变小时仍会共同伸缩。