alt+z在vscode中不触发自动换行，大概率是被系统、输入法或后台软件截获；切英文输入法、禁用冲突工具可解决，或改用ctrl+k ctrl+z替代，亦可通过keybindings.json精准覆盖绑定。
Alt+Z 在 VSCode 中不触发自动换行，大概率是被系统或输入法截胡了
VSCode 的 toggle word wrap 默认绑定在 alt+z，但它不是“硬编码不可改”的系统级快捷键——它只是个普通键盘事件，一旦被操作系统、桌面环境或输入法提前消费，VSCode 就收不到。Windows 下部分杀毒软件、远程控制工具（如 TeamViewer）会全局监听 alt+z；macOS 中某些辅助功能（如 Zoom 缩放快捷键）也可能占用该组合；而中文输入法（尤其搜狗、百度拼音）在激活状态下，alt+z 常被当作中英文切换或符号面板唤起键，直接吞掉。
- 先切到纯英文输入法（
win+space或cmd+space），再试alt+z—— 如果这时能换行，问题就锁定在输入法 - 临时退出所有非必要后台工具（特别是带全局热键的录屏、翻译、OCR 类软件）
- 在记事本或 TextEdit 里按
alt+z，看是否弹出任何响应 —— 若有，说明系统层已注册，VSCode 无解，只能换键
用 Ctrl+K Ctrl+Z 替代 Alt+Z 是最稳妥的绕过方案
ctrl+k ctrl+z 是 VSCode 内置的 chord 组合键（先按 ctrl+k 松开，再按 ctrl+z），它天然避开绝大多数系统/输入法拦截，因为系统级热键极少监听两段式序列。这个组合默认就绑定 toggle word wrap，无需配置，开箱即用。
- 注意不是同时按住 —— 是
ctrl+k→ 松开 →ctrl+z - 如果仍无效，说明有扩展在监听
ctrl+k前缀（比如 GitLens 的ctrl+k ctrl+r查提交），但ctrl+k ctrl+z目前无主流扩展占用，冲突概率极低 - 终端（Terminal）里该组合无效，这是正常行为 ——
when条件默认限定为editorTextFocus，不影响使用
想永久保留 Alt+Z？必须进 keybindings.json 精准覆盖
图形界面里重绑 alt+z 常失败，因为旧绑定没被真正清除。唯一可靠方式是手动编辑 keybindings.json，加一条带严格 when 条件的覆盖规则：
[{
"key": "alt+z",
"command": "editor.action.toggleWordWrap",
"when": "editorTextFocus && !editorReadonly && !inDebugRepl"
}]
-
when条件越具体越好：排除调试控制台（inDebugRepl）、只读文件（!editorReadonly）、确保只在代码编辑器生效（editorTextFocus） - 别删默认项，直接在数组末尾追加新对象 —— VSCode 按顺序匹配，后写的优先
- JSON 语法必须合法：逗号不能多也不能少，字符串用双引号，
key值大小写敏感（alt+z不是Alt+Z） - 改完保存，不用重启，但要确保焦点在编辑器内再试
Mac 用户额外注意 meta 键和 Spotlight 的双重干扰
macOS 下 alt+z 实际对应 option+z，但很多用户误以为是 cmd+z（撤销），导致查错方向偏差。更麻烦的是，Spotlight 默认不占 option+z，但如果你启用了「缩放」辅助功能（System Settings → Accessibility → Zoom → Keyboard shortcuts），option+z 可能被设为「缩放关闭」——这时 VSCode 完全收不到该事件。
- 检查路径：
System Settings → Accessibility → Zoom → Keyboard shortcuts，把option+z改成别的或禁用 - VSCode 配置里
key字段写alt+z即可，不用写option+z—— VSCode 抽象层已统一处理 - 如果用 Karabiner-Elements 等键位映射工具，务必检查其规则是否劫持了
alt+z
