Wezterm 终端窗口自动填充优化方案

背景介绍

Wezterm 是一款现代化的终端模拟器，在使用过程中，用户发现当调整终端窗口大小时，窗口填充(padding)会出现不平衡现象。具体表现为右侧和底部会留下比左侧和顶部更多的空白区域，导致终端内容显示不居中，影响视觉体验。

问题分析

终端窗口的填充计算涉及多个因素：

1. 窗口尺寸与终端单元格(grid)尺寸的匹配关系
2. 字体大小对单元格布局的影响
3. 标签栏(tab bar)和窗格(pane)等UI元素占用的空间

当窗口尺寸不能精确匹配整数倍的单元格尺寸时，就会产生填充不平衡的问题。传统的解决方案是手动调整字体大小，但这会影响用户体验，且难以同时平衡左右和上下的填充。

解决方案探索

动态计算填充方案

通过Wezterm提供的Lua API，可以实现窗口大小变化时的动态填充计算：

function recompute_padding(window)
  local overrides = window:get_config_overrides() or {}
  local win_dims = window:get_dimensions()
  local pane_dims = window:active_pane():get_dimensions()

  local new_padding = {
    left = math.floor((win_dims.pixel_width - pane_dims.pixel_width)/2),
    top = math.floor((win_dims.pixel_height - pane_dims.pixel_height)/2) - 10,
  }
  overrides.window_padding = new_padding
  window:set_config_overrides(overrides)
end

此方案通过计算窗口与窗格之间的尺寸差，动态设置左右和上下的填充值，使内容居中显示。

防止无限缩小问题

为避免填充值无限缩小的问题，可以采用重置默认填充的方法：

local function minimize_padding(window, pane, cfg_padding)
  -- 先重置为默认填充
  local overrides = window:get_config_overrides() or {}
  overrides.window_padding = cfg_padding
  window:set_config_overrides(overrides)

  -- 然后计算居中填充
  local vert_gap_size = window:get_dimensions().pixel_height - pane:get_dimensions().pixel_height
  local horz_gap_size = window:get_dimensions().pixel_width - pane:get_dimensions().pixel_width
  overrides.window_padding = {
    left = horz_gap_size * 1/2,
    right = horz_gap_size * 1/2,
    top = vert_gap_size * 1/2,
    bottom = vert_gap_size * 1/2,
  }
  window:set_config_overrides(overrides)
end

基于窗口尺寸的预设填充方案

对于更精确的控制，可以为特定窗口尺寸预设填充值：

local padding_table = { w = {}, h = {} }

-- 为不同窗口尺寸设置填充值
padding_table.w[1920] = { left = 0, right = 0 }
padding_table.h[1080] = { top = 4, bottom = 5 }

padding_table.w[1914] = { left = 2, right = 2 }
padding_table.h[1074] = { top = 1, bottom = 2 }

padding_table.w[954] = { left = 2, right = 2 }
padding_table.h[534] = { top = 4, bottom = 5 }

function compute_padding(window, cfg_padding)
  local w = cfg_padding.w[window:get_dimensions().pixel_width]
  local h = cfg_padding.h[window:get_dimensions().pixel_height]

  local overrides = window:get_config_overrides() or {}
  overrides.window_padding = {
    left = w.left,
    right = w.right,
    top = h.top,
    bottom = h.bottom,
  }
  window:set_config_overrides(overrides)
end

实现建议

1. 事件监听：通过监听窗口大小变化事件(window-resized)和配置重载事件(window-config-reloaded)来触发填充计算

2. 性能优化：避免在频繁调整窗口大小时进行过多的计算，可以考虑添加防抖(debounce)机制

3. UI元素考虑：计算时应考虑标签栏、状态栏等UI元素占用的空间，确保终端内容区域正确居中

4. 用户体验：对于动态调整方案，可以添加过渡动画，使填充变化更加平滑

总结

Wezterm的填充优化是一个涉及窗口管理、字体渲染和UI布局的复杂问题。通过Lua脚本可以实现动态填充调整，但需要考虑多种边界情况。未来Wezterm可能会在核心代码中提供更完善的自动填充解决方案，在此之前，上述脚本方案提供了可行的替代方法。

对于普通用户，建议从简单的动态计算方案开始尝试；对于高级用户，可以基于窗口尺寸预设填充值，获得更精确的控制效果。无论采用哪种方案，都能显著改善Wezterm在窗口调整时的视觉体验。