Squirrel配置攻略：从入门到精通的参数调校指南

2026-04-22 09:51:51作者：傅爽业Veleda

核心配置解析

功能概述

Squirrel输入法的核心配置文件squirrel.yaml是实现个性化输入体验的基础，包含键盘布局、输入行为等关键设置。通过合理配置这些参数，可以显著提升输入效率和使用体验。

核心参数

keyboard_layout ★★★★★
控制输入法切换时使用的拉丁键盘布局，决定输入体验的基础框架。
取值范围：last（使用上次布局）、default（默认US布局）、custom（自定义布局标识）
```
keyboard_layout: default  # 使用系统默认的US (ABC)键盘布局
```
chord_duration ★★★☆☆
设置和弦输入的识别时长阈值，影响快速输入时的响应灵敏度。
取值范围：0.05-0.3（单位：秒），建议值0.1-0.2
```
chord_duration: 0.15  # 设置150毫秒的和弦识别窗口
```

实战示例

基础配置模板：

# 基础输入行为配置
keyboard_layout: last          # 记忆上次使用的键盘布局
chord_duration: 0.12           # 优化快速输入体验
preedit_style: composition     # 启用组合式预编辑模式

界面个性化

功能概述

Squirrel提供丰富的界面定制选项，通过style配置段可以调整候选词面板的视觉呈现，包括颜色方案、字体样式和布局排列，满足不同用户的审美需求和使用场景。

核心参数

color_scheme ★★★★☆
控制候选词面板的配色方案，支持明暗主题自动切换。
内置方案：native（系统主题）、solarized_light（亮色主题）、solarized_dark（暗色主题）
```
color_scheme: solarized_light       # 默认亮色主题
color_scheme_dark: solarized_dark   # 暗色模式下自动切换
```
font_face 与 font_point ★★★★☆
分别控制候选词的字体和字号，影响阅读清晰度和界面紧凑度。
取值范围：font_point建议14-24（单位：磅）
```
font_face: 'PingFang SC'   # 使用苹方简体
font_point: 18             # 标准显示字号
label_font_point: 16       # 候选编号字号
```
corner_radius ★★☆☆☆
控制候选面板的圆角弧度，影响界面视觉风格。
取值范围：0-20（单位：像素）
```
corner_radius: 8           # 8px圆角设计
hilited_corner_radius: 6   # 选中项略小圆角
```

实战示例

现代简约风格配置：

style:
  color_scheme: clean_white        # 简约白色主题
  text_orientation: horizontal     # 水平排列候选词
  inline_preedit: true             # 启用行内预编辑
  font_face: 'SF Pro Display'      # 使用SF系列字体
  font_point: 17
  line_spacing: 4                  # 紧凑行间距
  spacing: 8                       # 元素间距
  corner_radius: 10                # 柔和圆角

场景适配方案

功能概述

通过应用程序特定配置，可以为不同软件设置差异化的输入行为，解决特定场景下的兼容性问题和优化输入体验，尤其适用于开发环境和专业工具。

核心参数

app_options ★★★★☆
针对特定应用程序的配置集合，键为应用Bundle ID或名称。
常用参数：ascii_mode（强制ASCII输入）、auto_commit（自动上屏）

app_options:
  com.apple.Terminal:
    ascii_mode: true           # 终端中默认英文输入
  com.microsoft.VSCode:
    inline_preedit: false      # 代码编辑器禁用行内编辑

实战示例

多场景适配配置：

app_options:
  # 终端应用配置
  com.apple.Terminal:
    ascii_mode: true
    send_raw_key: true
  
  # 代码编辑器配置
  com.microsoft.VSCode:
    ascii_mode: false
    auto_commit: true
    page_size: 5                 # 候选词每页显示5个
  
  # 浏览器配置
  com.google.Chrome:
    inline_preedit: true
    candidate_list_layout: vertical  # 垂直候选列表

进阶优化策略

功能概述

高级用户可通过调整界面精细参数和输入行为阈值，进一步优化输入体验，实现接近原生应用的操作流畅度和个性化交互模式。

核心参数

page_size ★★★☆☆
控制每页显示的候选词数量，平衡视野范围和选择效率。
取值范围：3-10（建议值：5-8）
```
page_size: 6  # 每页显示6个候选词
```
horizontal_candidate ★★☆☆☆
控制候选词水平排列时的最大显示数量。
取值范围：3-8（建议值：5）
```
horizontal_candidate: 5  # 水平模式最多显示5个候选
```
preedit_format ★★★☆☆
自定义预编辑文本的格式，支持HTML-like标签。
```
preedit_format: '<b>%s</b>'  # 预编辑文本加粗显示
```

实战示例

高效输入配置：

# 输入行为优化
page_size: 7
horizontal_candidate: 5
preedit_format: '<span style="color:#333">%s</span>'

# 响应速度优化
commit_delay: 50        # 输入确认延迟50ms
key_binder:
  bindings:
    - { when: always, accept: "Control+p", send: Page_Up }
    - { when: always, accept: "Control+n", send: Page_Down }