首页
/ 鼠须管输入法候选栏布局配置变更解析

鼠须管输入法候选栏布局配置变更解析

2025-06-10 21:24:28作者:宣海椒Queenly

在鼠须管输入法1.0.0版本更新中,开发者对候选栏布局的配置方式进行了重要调整。原先通过horizontal: true/false控制横竖排显示的方式已被弃用,取而代之的是更语义化的candidate_list_layout参数。

配置变更背景

旧版配置中,用户通常在squirrel.custom.yaml文件中使用horizontal: true来实现候选字横排显示。这种配置方式存在两个主要问题:

  1. 参数命名不够直观,无法清晰表达其功能意图
  2. 与其他配置项的命名风格不一致

新版配置方案

当前版本(1.0.2+)应采用以下配置方式:

patch:
  style:
    candidate_list_layout: linear  # 横排显示
    # candidate_list_layout: stacked  # 竖排显示

配置位置说明

正确的配置位置应位于:

  1. 用户自定义配置文件(squirrel.custom.yaml)的patch.style节点下
  2. 部署后会在squirrel.yaml中生成对应配置

常见问题排查

若遇到配置不生效的情况,建议检查:

  1. 配置文件语法是否正确(注意缩进和冒号后的空格)
  2. 是否在正确的配置节点下添加参数
  3. 部署后是否生成了预期的squirrel.yaml文件
  4. 是否清除了旧的配置方式避免冲突

技术建议

对于从旧版升级的用户,建议:

  1. 全面检查并更新所有自定义配置
  2. 删除废弃的horizontal参数以避免潜在冲突
  3. 了解新版配置系统的设计理念,采用更规范的配置方式

这一变更体现了鼠须管项目向更规范、更易维护的配置系统发展的趋势,虽然带来了短暂的适配成本,但从长远看将提升配置的可读性和可维护性。

登录后查看全文
热门项目推荐
相关项目推荐