snacks.nvim 插件中 which-key 描述文本的自定义优化方案

在 snacks.nvim 插件中，当用户为功能开关（toggle）设置快捷键映射时，默认会在 which-key 弹出窗口中显示类似"Enable "和"Disable "的描述文本。由于"Disable"比"Enable"多一个字符，这会导致选项名称无法完美对齐，影响视觉一致性。

问题分析

默认的 which-key 描述文本存在以下特点：

1. 使用"Enable"和"Disable"作为前缀
2. 前缀长度不一致导致对齐问题
3. 缺乏自定义选项来调整这些描述文本

解决方案

snacks.nvim 最新版本已通过引入 which_key_prefix 配置选项解决了这个问题。该选项允许用户自定义 which-key 描述中的前缀文本，提供了以下灵活性：

1. 可以调整前缀文本以实现完美对齐（例如在"Enable"后添加空格）
2. 可以统一使用"Toggle"前缀保持一致性
3. 可以完全移除前缀，仅显示功能名称

配置示例

用户现在可以通过以下方式自定义 which-key 描述：

require('snacks').setup({
  which_key_prefix = {
    enable = "Enable ",  -- 注意末尾空格
    disable = "Disable "
  }
})

或者使用统一前缀：

which_key_prefix = {
  enable = "Toggle ",
  disable = "Toggle "
}

甚至完全简化：

which_key_prefix = {
  enable = "",
  disable = ""
}

技术实现原理

该功能通过在插件内部添加配置选项，并在生成 which-key 描述时使用这些自定义前缀而非硬编码文本实现。核心逻辑包括：

1. 默认配置保持向后兼容性
2. 用户配置会覆盖默认值
3. 描述文本生成时动态应用这些前缀

最佳实践建议

1. 对于注重对齐的用户，建议在"Enable"后添加空格
2. 对于追求一致性的用户，建议使用"Toggle"前缀
3. 对于极简主义用户，可以直接省略前缀