为何Neovim中vim.api.nvim_set_keymap命令行补全失效，vim.keymap.set正常？

现象回顾 #

在Neovim命令模式下，输入前缀字符后按<up>，默认会匹配历史中以该前缀开头的命令，但两种映射方式出现不同结果：

• 错误表现：使用vim.api.nvim_set_keymap("x", "<c-p>", "<up>", { noremap = true })和vim.api.nvim_set_keymap("x", "<c-n>", "<down>", { noremap = true })时，输入字符后按<c-p>/<c-n>会忽略已输入前缀，循环所有历史命令
• 正确表现：使用vim.keymap.set("c", "<c-p>", "<up>")和vim.keymap.set("c", "<c-n>", "<down>")时，输入:e后按<c-p>能正常循环以e开头的历史命令

核心原因 #

1. 模式参数错误
   你在vim.api.nvim_set_keymap中指定的模式是"x"（视觉选择模式），而非命令模式对应的"c"。这意味着你设置的<c-p>/<c-n>映射仅在视觉模式生效，命令模式下的按键仍然是默认行为，导致前缀匹配失效。

2. API默认行为差异（次要）
   vim.api.nvim_set_keymap默认不启用非递归映射（noremap=false），你显式设置noremap=true后与vim.keymap.set的默认行为一致，但模式错误是导致问题的主要原因。

修复方案 #

将vim.api.nvim_set_keymap的模式参数从"x"改为"c"，即可实现与vim.keymap.set相同的前缀匹配效果：

vim.api.nvim_set_keymap("c", "<c-p>", "<up>", { noremap = true })
vim.api.nvim_set_keymap("c", "<c-n>", "<down>", { noremap = true })

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