如何正确配置nvim的tab缩进，避免重启后出现E481报错

问题根源 #

你遇到的重启后按Tab报错、手动source配置后恢复正常的情况，本质是你的Tab键映射被加载顺序更靠后的其他配置或者第三方插件覆盖了。手动source你的配置文件后，你的映射优先级会高于之前的冲突映射，因此功能恢复正常。E481报错是因为覆盖后的Tab映射指向了需要指定范围才能执行的Ex命令，正常输入时没有传递对应范围就会触发报错。

排查&解决步骤 #

• 第一步先确认冲突来源：重启Neovim后不要手动加载配置，直接执行命令:verbose nmap <Tab>，输出结果会展示普通模式下Tab键当前的生效映射，以及该映射的定义文件位置，即可定位到覆盖你配置的冲突来源。
• 调整你的映射加载顺序：将你写的Tab缩进相关映射移动到整个配置文件的最末尾，确保它是最后加载的配置项，优先级高于所有其他映射。如果使用了Lazy.nvim、Packer这类插件管理器，需要将这部分映射放在插件加载完成的回调逻辑中，避免被插件的默认映射覆盖。
• 针对常见冲突（补全插件）处理：如果你使用了nvim-cmp这类补全插件，这类插件默认会绑定Tab键用于选择补全项，是最常见的Tab映射冲突来源。你可以在补全插件的配置中关闭Tab的默认绑定，示例如下：

-- nvim-cmp 配置中添加以下内容，释放Tab键给自定义映射使用
mapping = {
  ['<Tab>'] = cmp.mapping(function(fallback)
    fallback()
  end, { 'i', 's' }),
  ['<S-Tab>'] = cmp.mapping(function(fallback)
    fallback()
  end, { 'i', 's' }),
}

• 可选：升级映射写法增强优先级：如果你使用Lua编写Neovim配置，可以替换旧的vimscript映射为vim.keymap.set写法，添加参数强制映射优先级，示例如下：

vim.keymap.set('n', '<Tab>', '>>_', { noremap = true, silent = true, nowait = true })
vim.keymap.set('n', '<S-Tab>', '<<_', { noremap = true, silent = true, nowait = true })
vim.keymap.set('i', '<S-Tab>', '<C-D>', { noremap = true, silent = true, nowait = true })
vim.keymap.set('v', '<Tab>', '>gv', { noremap = true, silent = true, nowait = true })
vim.keymap.set('v', '<S-Tab>', '<gv', { noremap = true, silent = true, nowait = true })

内容的提问来源于stack exchange，提问作者Mạnh Cao