如何查找Neovim/Vim中未被映射的按键组合用于新映射？

核心思路 #

先导出所有已定义的按键映射，再结合你的助记需求，筛选出未被占用、符合使用习惯的组合。

具体实现方法 #

1. 导出所有已用映射

• 手动查看并导出：
  执行以下命令分别查看不同模式的已用映射：
  • 普通模式：:verbose nmap
  • 可视模式：:verbose vmap
  • 插入模式：:verbose imap
    若要保存结果到文件，可先执行:redir! > used_maps.txt，再运行上述映射命令，最后执行:redir END，所有已用映射会被写入used_maps.txt文件。
• 借助插件：
  使用which-key.nvim插件，它会以可视化方式列出所有已定义的映射，直观展示各个前缀下的组合占用情况。

2. 筛选未使用的助记组合

• 先确定你偏好的前缀（比如你习惯的q前缀），列出该前缀下的所有候选组合（如q+a-z、0-9、常用符号）。
• 对比已用映射列表，排除已被占用的组合。
• 自动化排查（以普通模式q前缀为例）：
  可以用Lua脚本快速遍历检查：

  local chars = {'a','b','c','d','e','f','g','h','i','j','k','l','m','n','o','p','q','r','s','t','u','v','w','x','y','z'}
  for _, char in ipairs(chars) do
    local map = vim.api.nvim_get_keymap('n')
    local used = false
    for _, m in ipairs(map) do
      if m.lhs == 'q'..char then
        used = true
        break
      end
    end
    if not used then
      print('未使用组合：q'..char)
    end
  end
  

  运行后会输出q前缀下所有未被占用的字母组合。

3. 推荐组合的选择逻辑

• 优先选符合助记、易按压的组合：比如和操作首字母匹配（如qa对应Quick Action），或手指位置舒适的按键（如q+home行字母）。
• 主动避开已有肌肉记忆的组合：先整理出你日常高频使用的映射，排除前缀或组合和这些冲突的候选，避免误触。

针对你的具体需求说明 #

• 对于你提到的“已有肌肉记忆的组合没意识到被占用”：通过导出并核对已用映射列表，能明确所有已占用组合，避免后续误定义。
• 对于“找X个最推荐的未使用组合”：从你偏好的前缀（如q、<leader>）入手，先筛选出该前缀下未被占用的组合，再按助记和按压舒适度排序，选出最适合的X个。

内容的提问来源于stack exchange，提问作者Gonzalo Matheu