vim-commentary自定义gg映射失效问题求助

问题情况 #

在.vimrc中配置了可视化模式下的自定义映射：

vnoremap gg <PLUG>Commentary

但在可视化模式按下gg时，仅出现终端闪烁，无注释/取消注释效果；默认映射gc可正常工作。执行:map gg确认映射已加载，返回：

v  gg          * <Plug>Commentary

解决方法 #

将配置中的vnoremap替换为vmap：

vmap gg <Plug>Commentary

原因说明 #

• vnoremap是非递归映射，会直接将按键绑定到指定内容，不会解析内容中的嵌套映射（比如<Plug>Commentary本身是vim-commentary插件定义的一层内部映射）。
• vmap是递归映射，会先解析<Plug>Commentary对应的插件内部逻辑，从而正确触发注释功能。
• 可视化模式下默认的gg功能（跳转到首行）会被这个自定义映射覆盖，若需要保留原功能，建议选择其他未被占用的按键组合。

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