鼠须管输入法候选栏布局变更解析：从horizontal到linear的演进

在鼠须管输入法1.0.0版本后的更新中，开发者对候选栏的布局控制参数进行了重要调整。原先通过horizontal: true来控制候选字横排显示的方式已被弃用，取而代之的是更明确的candidate_list_layout: linear参数设置。

参数变更背景

候选栏布局是输入法用户体验的重要组成部分。在早期版本中，鼠须管使用horizontal这个布尔值参数来控制候选字的排列方向。这种设计虽然简单，但在语义表达上不够清晰，特别是当需要支持更多布局类型时显得扩展性不足。

新旧参数对比

• 旧参数：horizontal: true/false

  • 优点：简单直观
  • 缺点：语义不明确，扩展性差

• 新参数：candidate_list_layout

  • 可选值：linear(横排)或stacked(竖排)
  • 优点：语义明确，易于扩展新布局类型
  • 引入版本：1.0.0

配置方法详解

在自定义配置文件中，正确的设置方式应为：

patch:
  style:
    candidate_list_layout: linear

这个参数应该放置在style层级下，而不是color scheme配置中。这样的设计使得布局控制与视觉样式分离，更符合配置的逻辑分层。

升级注意事项

1. 从旧版本升级时，原有的horizontal参数将不再生效
2. 建议用户在升级后检查配置文件，确保使用新参数
3. 如果同时存在新旧参数，系统会优先采用新参数

开发者考量

这一变更反映了鼠须管开发团队对配置系统长期维护性的考虑。通过使用更具描述性的参数名，不仅提高了代码可读性，也为未来可能增加的更多布局类型预留了扩展空间。这种渐进式的改进是开源项目持续优化的典型范例。

对于用户而言，理解这类参数变更有助于更好地维护自己的输入法配置，并在升级时快速解决兼容性问题。记住，当遇到显示异常时，查阅最新版本文档中的参数说明往往是最直接的解决方案。