Alt+Z在Vim模式下失效，主因是vscode-vim插件默认拦截该组合键；需在settings.json中配置"vim.handleKeys": {"<alt+z>": false}放行，或改用Ctrl+K Ctrl+Z替代。
VSCode 自动换行（editor.wordWrap）本身不与 Vim 模式冲突，真正出问题的是「换行触发方式」和「Vim 模式下快捷键被劫持」——比如你按 Alt+Z 没反应，或换行后光标行为异常，根本不是设置没生效，而是按键没传到编辑器层面。
为什么 Alt+Z 在 Vim 模式下失效？
VSCode 的 Alt+Z 是原生命令 editor.action.toggleWordWrap 的快捷键，但 Vim 插件默认会拦截几乎所有组合键（尤其含 Alt、Ctrl 的），除非显式放行。
- 检查当前是否处于 Normal 模式：右下角显示
NORMAL才有效；Insert 或 Visual 模式下该快捷键直接被忽略 - 确认
vim.handleKeys配置中未禁用<alt+z>—— 默认它会被 Vim 插件吞掉 - 若已启用
vim.useCtrlKeys: true，Alt键同样可能被纳入拦截范围，需手动放行
临时解决：在 settings.json 中加这一行：
"vim.handleKeys": { "<alt+z>": false }
这样 VSCode 就能收到并执行换行切换，Vim 模式照常运行。
editor.wordWrap 设为 on 却不生效？优先级陷阱
语言特定设置（language-specific settings）的优先级高于全局设置，JSON、Markdown、Log 文件等类型常被默认设为 "off"，导致你改了全局却毫无反应。
- 打开一个不换行的文件，看右下角语言标识（如
JSON），点击它 → “Configure 'JSON' language based settings” - 检查是否有
"editor.wordWrap": "off"—— 这行会覆盖用户级设置 - 删掉或改成
"on"，或直接在语言配置块里写："[json]": { "editor.wordWrap": "on" } - 别选
auto：它只在窗口宽度小于内容时才折行，实际几乎等于off
Vim 模式下换行后光标跳转错乱？别怪插件，是渲染机制
VSCode 的软换行（soft wrap）只是视觉折行，不产生真实换行符。但 Vim 插件的光标移动逻辑（如 j/k）默认按物理行计算，遇到长行软折后，j 可能“跳过”一整段视觉折行，造成定位偏差。
- 这不是 bug，是设计使然：Vim 插件看到的是原始文本行，VSCode 渲染层额外做了折行
- 想让
j/k按视觉行移动？加配置："vim.whichwrap": "b,s,,h,l"（启用左右键跨折行），但上下键仍按物理行 - 真正一致的体验要靠
gj/gk：它们专为软折行设计，必须手动映射或习惯使用 - 如果频繁需要视觉导航，建议关闭软换行，改用
editor.wordWrapColumn+ 格式化工具硬折行（如 Prettier 的printWidth）
最易被忽略的一点：Vim 模式下所有快捷键行为都依赖焦点是否落在编辑器文本区——终端、侧边栏、搜索框、甚至设置页里按 Alt+Z 都无效。先确认光标在代码里，再查配置。
