AstroNvim基础按键映射失效：t与k键功能互换异常求助

想要在AstroNvim中互换t和k键的功能，在Neovim命令行执行:noremap k t和:noremap t k可以正常实现，但写入配置后出现异常。克隆https://github.com/AstroNvim/user_example仓库后，修改user/mappings.lua为以下代码：

return {
  [""] = {
    ["t"] = {"k", desc = "Move up"},
    ["k"] = {"t", desc = "Till"},
  },
}

配置完成后，t键可以正常向上移动，但k键也只能向上移动，无法实现t的"跳转到指定字符前"功能。

额外观察到的现象：

• 调换两行映射的顺序，结果依旧，两个键都只能向上移动；
• 添加remap=false参数后，行为没有变化；
• 将模式键从[""]改为["n"]（或n）时，按下k键会报错undefined variable: t。

解决提示 #

问题的核心在于AstroNvim的映射配置对字符串目标的解析逻辑：当你直接将映射目标设为"k"或"t"这类单个字符时，AstroNvim会默认将其当作Ex命令而非普通按键序列来执行，这就导致了异常行为：

1. 模式设为""（所有模式）时，普通模式下的映射被错误解析，最终两个键都指向了k的功能；
2. 模式设为"n"时，执行:t命令会报错，因为t并非合法的Ex命令，Lua解析时会将其当作未定义变量处理。

要实现和命令行:noremap完全一致的非递归双向映射，有两种可行方案：

方案1：使用normal!命令模拟按键 #

在mappings.lua中通过<Cmd>normal! {按键}<CR>的方式明确指定要执行普通模式的按键操作，并开启非递归映射：

return {
  n = {
    ["t"] = { "<Cmd>normal! k<CR>", desc = "Move up", noremap = true },
    ["k"] = { "<Cmd>normal! t<CR>", desc = "Till", noremap = true },
  },
}

• normal!表示非递归执行普通模式命令，避免映射循环；
• noremap=true确保映射是非递归的，和命令行:noremap行为一致。

方案2：直接调用Neovim原生API #

绕过AstroNvim的映射封装，直接使用vim.api.nvim_set_keymap来配置映射，这种方式和命令行操作完全等价：

-- 配置普通模式下的非递归双向映射
vim.api.nvim_set_keymap("n", "t", "k", { noremap = true, desc = "Move up" })
vim.api.nvim_set_keymap("n", "k", "t", { noremap = true, desc = "Till" })

-- 如果需要在其他模式（比如可视模式）也生效，添加对应模式的映射
vim.api.nvim_set_keymap("v", "t", "k", { noremap = true })
vim.api.nvim_set_keymap("v", "k", "t", { noremap = true })

return {}

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