VSCode如何配置Vim键位绑定 VSCode模拟Vim编辑模式的详细设置教程-VSCode-PHP中文网

VSCode如何配置Vim键位绑定 VSCode模拟Vim编辑模式的详细设置教程

蓮花仙者

发布： 2025-08-08 17:42:02

原创

1128人浏览过

要让vscode用上vim的丝滑操作，只需安装vscodevim插件并进行个性化配置即可实现；首先安装插件后vim模式默认启用，可使用hjkl移动、i进入插入模式、esc退出、:进入命令模式等基础操作，接着通过settings.json或设置界面进行自定义配置：1. 开启vim.usesystemclipboard以使用系统剪贴板；2. 启用vim.hlsearch实现搜索高亮；3. 在vim.insertmodekeybindings中添加{ "before": ["j", "j"], "after": ["<esc>"] }实现jj快速退出插入模式；4. 在vim.normalmodekeybindings中添加{ "before": ["<c-s>"], "commands": ["workbench.action.files.save"] }实现ctrl+s保存；5. 设置vim.leader为,并在vim.normalmodekeybindings中添加{ "before": [",", "w"], "commands": ["workbench.action.files.save"] }实现,w保存文件；配置位于settings.json中，可通过“preferences: open settings (json)”打开；常见问题包括插件冲突、命令冲突、中文输入法异常和性能下降，可通过排查插件、调整快捷键、切换输入法或优化配置解决；高效使用需掌握vim基础命令、自定义键位、使用宏和兼容插件；解决与代码补全冲突的方法包括修改触发快捷键、使用coc.nvim等vim补全插件或重新映射补全键位；调试配置时应查看vscode日志、使用json校验工具、逐步添加配置项并参考官方文档，确保配置正确生效。

VSCode如何配置Vim键位绑定 VSCode模拟Vim编辑模式的详细设置教程

要让VSCode用上Vim的丝滑操作，其实不难，装个插件，简单配置一下就搞定了。关键在于理解插件的设置，然后根据自己的习惯微调。

解决方案

安装VSCodeVim插件： 打开VSCode，在扩展商店搜索"VSCodeVim"并安装。这是实现Vim键位绑定的核心。
启用Vim模式： 安装完成后，VSCodeVim默认启用。如果想临时禁用，可以在命令面板（
```
Ctrl+Shift+P
```
登录后复制
或
```
Cmd+Shift+P
```
登录后复制
）中搜索"Vim: Disable Vim"；启用则搜索"Vim: Enable Vim"。
基本使用： 现在，你就可以在VSCode中使用Vim的基本命令了，比如
```
hjkl
```
登录后复制
移动光标，
```
i
```
登录后复制
进入插入模式，
```
Esc
```
登录后复制
退出插入模式，
```
:
```
登录后复制
进入命令模式等等。
自定义配置： 真正的灵魂在于自定义配置。打开VSCode的设置（
```
Ctrl+,
```
登录后复制
或
```
Cmd+,
```
登录后复制
），搜索"vim"。你会看到一堆配置项。
- ```
vim.useSystemClipboard
```
  登录后复制
  : 是否使用系统剪贴板。建议开启，方便与外部程序复制粘贴。
- ```
vim.hlsearch
```
  登录后复制
  : 是否高亮搜索结果。Vim用户应该习惯这个。
- ```
vim.insertModeKeyBindings
```
  登录后复制
  : 在插入模式下的键位绑定。比如，你可以设置
```
jj
```
  登录后复制
  快速退出插入模式，避免频繁按
```
Esc
```
  登录后复制
  。
- ```
vim.normalModeKeyBindings
```
  登录后复制
  : 在普通模式下的键位绑定。这是自定义Vim操作的核心。
- ```
vim.leader
```
  登录后复制
  : 设置leader键。默认是
```
\
```
  登录后复制
  ，可以改成
```
,
```
  登录后复制
  或者其他你喜欢的键。
高级配置示例：

Onlook
专为前端设计师和开发者打造的视觉编辑工具

108

查看详情
- 插入模式下
```
jj
```
  登录后复制
  退出： 在
```
vim.insertModeKeyBindings
```
  登录后复制
  中添加：
```
[
  {
    "before": ["j", "j"],
    "after": ["<Esc>"]
  }
]
```
  登录后复制
- 普通模式下
```
Ctrl+s
```
  登录后复制
  保存： 在
```
vim.normalModeKeyBindings
```
  登录后复制
  中添加：
```
[
  {
    "before": ["<C-s>"],
    "commands": ["workbench.action.files.save"]
  }
]
```
  登录后复制
- Leader键映射： 比如，设置leader键为
```
,
```
  登录后复制
  ，然后用
```
,w
```
  登录后复制
  保存文件。先设置
```
vim.leader
```
  登录后复制
  为
```
,
```
  登录后复制
  ，然后在
```
vim.normalModeKeyBindings
```
  登录后复制
  中添加：
```
[
  {
    "before": [",", "w"],
    "commands": ["workbench.action.files.save"]
  }
]
```
  登录后复制
配置文件位置： 所有的Vim配置都写在VSCode的
```
settings.json
```
登录后复制
文件中。你可以通过
```
Ctrl+Shift+P
```
登录后复制
，然后搜索"Preferences: Open Settings (JSON)"打开这个文件。

VSCodeVim插件有哪些常见问题？

插件冲突： VSCode的很多插件可能会与VSCodeVim冲突，导致键位绑定失效或者行为异常。遇到这种情况，可以尝试禁用其他插件，逐一排查。
命令冲突： VSCode本身的一些快捷键可能与Vim的命令冲突。可以通过修改VSCode的快捷键设置（
```
Ctrl+K Ctrl+S
```
登录后复制
或
```
Cmd+K Cmd+S
```
登录后复制
）来解决。
中文输入法问题： 在中文输入法下，Vim的某些命令可能会失效。建议在Vim模式下切换到英文输入法。
性能问题： 在处理大型文件时，VSCodeVim可能会导致性能下降。可以尝试禁用一些不常用的Vim功能，或者增加VSCode的内存限制。

如何更高效地使用VSCodeVim？

学习Vim基础： 如果你之前没有用过Vim，建议先学习Vim的基础知识。网上有很多Vim教程，比如
```
vimtutor
```
登录后复制
。
熟练使用Vim命令： 掌握常用的Vim命令，比如
```
d
```
登录后复制
删除，
```
y
```
登录后复制
复制，
```
p
```
登录后复制
粘贴，
```
gg
```
登录后复制
到文件头，
```
G
```
登录后复制
到文件尾，
```
/
```
登录后复制
搜索等等。
自定义键位绑定： 根据自己的习惯，自定义键位绑定，提高效率。
利用Vim的宏： Vim的宏功能非常强大，可以录制一系列操作，然后重复执行。
使用Vim的插件： VSCodeVim支持一些Vim的插件，比如nerdtree，可以方便地浏览文件。

如何解决VSCodeVim与代码补全的冲突？

VSCode的代码补全功能很强大，但是在使用VSCodeVim时，可能会与Vim的命令冲突。比如，在输入代码时，可能会误触Vim的命令。

修改触发补全的快捷键： 可以修改VSCode触发补全的快捷键，避免与Vim的命令冲突。在VSCode的快捷键设置中，搜索"editor.action.triggerSuggest"，修改快捷键。
使用Vim的补全插件： 可以使用Vim的补全插件，比如
```
coc.nvim
```
登录后复制
，它提供了更强大的补全功能，并且与VSCodeVim兼容。
自定义键位绑定： 可以自定义键位绑定，将补全功能映射到其他键位上。比如，可以将
```
Ctrl+Space
```
登录后复制
映射到补全功能。

如何调试VSCodeVim的配置？

调试VSCodeVim的配置，其实就是调试VSCode的

settings.json

登录后复制

文件。

查看VSCode的日志： VSCode的日志可以帮助你找到配置错误。可以通过
```
Ctrl+Shift+P
```
登录后复制
，然后搜索"Developer: Open View..."，选择"Log (Window)"打开日志。
使用JSON校验工具： 可以使用JSON校验工具，检查
```
settings.json
```
登录后复制
文件是否符合JSON格式。
逐步添加配置： 不要一次性添加所有的配置，可以逐步添加，每次添加后都测试一下，看看是否正常工作。
参考VSCodeVim的文档： VSCodeVim的文档非常详细，可以参考文档，了解各个配置项的含义。

以上就是VSCode如何配置Vim键位绑定 VSCode模拟Vim编辑模式的详细设置教程的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

VSCode代码操作提供器_上下文感知的重构建议 VSCode文件操作_高级文件系统API使用实战 VSCode产品图标主题_整体UI图标系统替换方案 VSCode Vue生态系统_单文件组件开发全流程 VSCode文本文档内容_编辑器文档模型管理机制