Neovim中LocalLeader键无法使用或设置的问题排查

• 根本原因：没给LocalLeader绑定任何实际功能
  默认情况下Vim/Neovim不会给LocalLeader预设任何快捷键映射，它只是一个「前缀标记」而已。你按\没反应太正常了——就像你按了Ctrl但没接着按其他键，当然不会有动作。
  先测试验证：在Neovim命令行输入nnoremap <LocalLeader>t :echo "LocalLeader works!"<CR>，回车后按你的LocalLeader键+t，如果能弹出"LocalLeader works!"的提示，说明键本身没问题，只是你没配置对应的映射而已。

• 配置加载顺序错误
  如果是在Lua里设置vim.g.maplocalleader，一定要把这段代码放在配置文件最开头，所有插件加载、自定义映射之前。比如有些插件会在初始化时读取maplocalleader的值，如果你把设置代码放在插件后面，插件用的还是旧的前缀；自己的映射如果写在设置前，也会用错前缀。
  正确顺序示例：

  -- 先设置LocalLeader
  vim.g.maplocalleader = ','
  -- 再加载插件（比如packer/lazy.nvim的配置）
  require('plugins')
  -- 最后写自定义映射
  vim.keymap.set('n', '<LocalLeader>s', ':w<CR>', { noremap = true })
  

• 映射语法有误
  在Lua里用vim.keymap.set时，要正确引用<LocalLeader>，别直接写你设置的字符（比如设成,就别写成',s'，虽然能生效，但用<LocalLeader>更灵活）。另外检查有没有漏写模式参数（比如第一个参数'n'代表普通模式），或者参数错误导致映射未生效。

• 终端键位冲突
  有些终端模拟器会把\或者你设置的LocalLeader键绑定成其他快捷键（比如终端切换标签、打开菜单），导致Neovim收不到按键信号。可以换个系统默认终端，或者用Neovim的GUI版本（如Neovide）测试，如果在GUI里能正常触发，就去终端的快捷键设置里删掉冲突绑定。

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