Neovim插件which-key.nvim与neoscroll.nvim的滚动冲突问题解析

问题现象
在使用which-key.nvim插件时，当同时启用neoscroll.nvim插件后，发现which-key的窗口无法通过<C-d>和<C-u>进行页面滚动操作。尝试自定义其他滚动键映射（如<C-j>/<C-k>）同样失效，而禁用neoscroll.nvim后问题消失。

技术背景

1. which-key.nvim：用于展示和管理Neovim键位映射的插件，当键位映射较多时会分页显示，支持页面滚动功能。
2. neoscroll.nvim：提供平滑滚动效果的插件，会重写系统的滚动行为。

问题本质
这是典型的功能插件与UI增强插件之间的行为冲突：

• neoscroll.nvim通过全局键位映射接管了滚动行为
• which-key.nvim作为临时浮动窗口，其内部滚动逻辑被neoscroll的全局映射覆盖

解决方案

1. 临时方案：在neoscroll配置中添加例外规则（需neoscroll支持）
2. 推荐方案：为which-key的滚动键位添加buffer = true参数，限制映射仅作用于当前buffer

vim.keymap.set('n', '<C-d>', '<C-d>zz', { 
  desc = 'Jump half page down', 
  buffer = true 
})

3. 深度方案：修改neoscroll的键位映射策略，使其能识别特殊窗口类型

技术启示

1. 插件开发时应考虑键位映射的作用域（全局/局部）
2. 功能插件与UI增强插件配合时，建议提供白名单机制
3. 用户遇到类似问题时，可通过:map命令检查键位映射的覆盖情况

最佳实践建议
对于插件组合使用场景，建议：

1. 优先使用buffer-local的键位映射
2. 为可视化元素（如浮动窗口）添加特殊标记
3. 在插件配置中预留排除机制接口