在AstroNvim中实现Dvorak布局下三组按键对的轻量互换

本人使用Dvorak键盘布局，正在尝试使用Neovim衍生编辑器AstroNvim。为延续已习惯的主行导航操作，希望在普通模式下互换三组按键对：

• t ↔ k
• n ↔ j
• s ↔ l

即普通模式下，t映射为k，T映射为K，ctrl+t映射为ctrl+k等组合键也需同步互换。

备注：

1. 了解许多用户建议直接学习Dvorak布局下的导航键位置，但本人无意采用此方案。
2. 曾尝试在AstroNvim的mappings.lua配置文件开头添加如下映射：

maps.n["t"] = { "k", desc = "swapping t and k" }
maps.n["k"] = { "t", desc = "swapping t and k" }
maps.n["T"] = { "K", desc = "swapping t and k" }
...

但该方式存在两个问题：

• 若考虑所有修饰键组合，映射代码行数过多；
• AstroNvim的默认映射会覆盖自定义设置，例如其mappings.lua第23行的默认映射：

maps.n["k"] = { "v:count ? 'k' : 'gk'", expr = true, desc = "Move cursor up" }

本人希望无需修改AstroNvim默认配置，仅通过添加独立的自定义映射配置文件（可在默认配置前后加载）实现需求。

1. 轻量批量映射实现 #

利用Neovim原生API结合循环批量处理按键互换，涵盖基础按键、大小写及修饰键组合。在AstroNvim的自定义配置目录（通常为~/.config/nvim/lua/user/）下创建mappings.lua文件，写入以下代码：

-- 定义需要互换的核心按键对
local swap_pairs = {
  { "t", "k" },
  { "n", "j" },
  { "s", "l" },
}

-- 处理普通模式下的基础小写、大写按键
for _, pair in ipairs(swap_pairs) do
  local from, to = unpack(pair)
  -- 小写按键互换
  vim.keymap.set("n", from, to, { desc = string.format("Swap %s ↔ %s", from, to), override = true })
  vim.keymap.set("n", to, from, { desc = string.format("Swap %s ↔ %s", to, from), override = true })
  -- 大写按键互换
  local from_upper, to_upper = string.upper(from), string.upper(to)
  vim.keymap.set("n", from_upper, to_upper, { desc = string.format("Swap %s ↔ %s", from_upper, to_upper), override = true })
  vim.keymap.set("n", to_upper, from_upper, { desc = string.format("Swap %s ↔ %s", to_upper, from_upper), override = true })
end

-- 处理带修饰键的组合（以Ctrl为例，可按需添加Shift/Ctrl+Shift等）
local modifiers = { "<C-" }
for _, mod in ipairs(modifiers) do
  for _, pair in ipairs(swap_pairs) do
    local from, to = unpack(pair)
    -- Ctrl+小写按键互换
    vim.keymap.set("n", mod .. from .. ">", mod .. to .. ">", { desc = string.format("Swap Ctrl+%s ↔ Ctrl+%s", from, to), override = true })
    vim.keymap.set("n", mod .. to .. ">", mod .. from .. ">", { desc = string.format("Swap Ctrl+%s ↔ Ctrl+%s", to, from), override = true })
    -- 如需支持Ctrl+大写，可添加以下两行
    -- local from_upper, to_upper = string.upper(from), string.upper(to)
    -- vim.keymap.set("n", mod .. from_upper .. ">", mod .. to_upper .. ">", { override = true })
    -- vim.keymap.set("n", mod .. to_upper .. ">", mod .. from_upper .. ">", { override = true })
  end
end

2. 确保自定义映射覆盖默认配置 #

AstroNvim的自定义配置默认在官方配置之后加载，只需在映射中添加override = true参数，即可强制覆盖默认映射（比如默认的k光标向上逻辑）。若需要更早加载自定义映射，可在~/.config/nvim/lua/user/init.lua中主动引入：

-- 在user/init.lua中添加，确保映射优先加载
require("user.mappings")

3. 效果验证 #

重启AstroNvim后，在普通模式下测试：

• 按下t应执行原k的光标向上逻辑（带数字计数时正常跳转）
• 按下k应执行原t的操作
• Ctrl+t应对应原Ctrl+k的功能

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