Neovim：插件规格与键位管理

增加插件前，先写出它解决的具体问题。例如“删除文字后仍想粘贴上次复制的内容”对应寄存器策略，“跨编辑器和复用器移动”对应按键交接。问题明确后，才能判断现有功能是否已经够用，以及新增插件带来哪些行为变化。

一份插件规格怎样生效

LazyVim 通过 lua/plugins/ 中返回的 Lua 表合并插件配置。下面保存为 lua/plugins/editing.lua：

return {
  {
    "gbprod/cutlass.nvim",
    event = "VeryLazy",
    opts = {},
  },
}

插件名标识来源，event 规定加载时机，opts 传给插件的设置函数。VeryLazy 是 lazy.nvim 的事件约定，不是“永远不加载”。通过 :Lazy 查看插件是否安装、何时加载，再测试它的实际行为。

已有发行版插件通常只需要覆盖 opts 或 keys。直接重新写 config 可能替换发行版原有的初始化逻辑，必须理解原配置后再使用。LazyVim 插件配置

把插件分成几个职责

这些是可选组件，不是完整开发环境的安装清单。LazyVim 已提供的插件无需重复声明整份默认配置。外部服务类插件按需启用，AI 生成的修改仍需要测试和差异审阅。

插件可以改变熟悉的默认动作

cutlass 调整删除/改写与寄存器的关系。安装后，用编辑练习重新检查 dd、ciw、yy 和 p，再决定是否保留。yanky 保存复制历史，但它与系统剪贴板提供者不是同一层机制。

flash 提供标签跳转与语法结构选择。它可以减少长距离移动，但基础搜索、文本对象和跳转历史仍值得掌握。插件失效时，这些基础动作仍能完成工作。

gitsigns 的 hunk 指一段相邻修改。局部暂存有助于组织提交；还原 hunk 会改变工作区内容，应先预览再决定。不要只根据行号旁的颜色判断准备提交了什么，最终仍用 git diff --cached 核对。

键位要有名称和范围

普通的全局键位放入 lua/config/keymaps.lua。下面定义一个容易检查的动作：

vim.keymap.set("n", "<leader>uN", function()
  vim.wo.relativenumber = not vim.wo.relativenumber
end, { desc = "Toggle relative numbers" })

n 表示普通模式，vim.wo 修改当前窗口选项，desc 帮助提示工具说明用途。定义前先检查是否与当前 LazyVim 或个人映射冲突。

键位似乎无效时执行：

:verbose nmap <leader>uN
:verbose nmap <C-h>

输出会说明映射内容及最后设置位置。只在某种文件中失效时，还要检查 buffer 局部映射和插件的附着事件。若 Neovim 根本没有收到按键，则继续查终端和 Zellij。

新增一项功能的顺序

1. 记录现有配置与 lazy-lock.json，选择一个练习文件或项目。
2. 只增加一个插件规格，检查插件管理器中的安装和加载结果。
3. 执行一个能体现功能差异的任务，例如复制后删除，再粘贴。
4. 检查是否覆盖默认键位、增加启动耗时或改变其他文件类型的行为。
5. 满足需要后再提交配置与锁文件；未解决问题则移除这份规格并恢复版本。

不要为每个插件都增加一套新前缀键。尽量沿用发行版的功能分组，并在提示中使用读者能理解的动作名称。

语言插件如何选择

优先从对应语言 extra 开始，再处理项目特有需求。C# 的 Roslyn 与 OmniSharp、Rust 的 rustaceanvim、Flutter 的 flutter-tools 都需要实际 SDK 和项目验证。某套配置在大项目中表现更好是有条件的经验，不应写成所有项目都成立的稳定性排名。

配置机制见语言工具，输入法和方向导航见远程与输入，升级与回退见维护篇。