Neovim按键映射需手动加载配置文件才生效的问题排查

核心原因 #

你的映射设置了buffer = true，这个参数会让映射仅绑定到执行该代码时的当前buffer。Neovim启动阶段加载配置时，当前的buffer是启动时的临时空buffer，后续你打开的实际文件buffer并不会自动继承这个buffer-local映射，所以启动后映射不生效。

手动source remap.lua时，你已经打开了目标文件，此时当前buffer是该文件的buffer，映射会绑定到这个buffer，因此生效。但由于是buffer-local映射，全局的:map命令默认只显示全局映射，需要执行:imap <buffer>才能看到这个映射。

解决方案 #

根据你的需求选择以下任意一种方式：

1. 改为全局映射（所有buffer可用）

如果希望在所有文件的插入模式下都能使用这个映射，直接移除buffer = true参数：

vim.keymap.set("i", "<C-s>", "<esc>yiwi<lt><esc>ea></><esc>hpF>a", { noremap = true })

2. 仅在特定文件类型中生效（推荐）

如果只需要在HTML、Markdown等特定类型文件中使用该映射，通过自动命令（autocmd）绑定到FileType事件，确保映射在对应文件buffer创建时生效：

vim.api.nvim_create_autocmd("FileType", {
  pattern = { "html", "markdown", "htmldjango" }, -- 按需添加需要生效的文件类型
  callback = function()
    vim.keymap.set("i", "<C-s>", "<esc>yiwi<lt><esc>ea></><esc>hpF>a", { noremap = true, buffer = true })
  end,
})

补充说明 #

• 替换<C-v>无效的原因和<C-s>一致，都是buffer = true参数导致的绑定对象错误，和按键本身是否被占用无关。
• 映射前后的print语句能正常输出，说明配置文件确实被加载了，只是映射的作用范围不符合预期。

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