Alt+Z在VSCode中不生效主因是被系统、输入法或后台软件拦截，需按焦点状态、语言设置、系统/输入法占用顺序排查；推荐用Ctrl+K Ctrl+Z替代，或在keybindings.json中添加带严格when条件的绑定。
Alt+Z 在 VSCode 中不生效，基本不是 VSCode 自身故障，而是被系统、输入法或后台软件“截胡”了。 它只是个普通键盘事件绑定，没有底层特权，一旦被提前消费，VSCode 就收不到。别急着重装或怀疑配置，先按顺序排查这三类真实原因。
Alt+Z 按了没反应？先确认焦点和语言设置
快捷键只在激活的文本编辑器中有效，其他区域（终端、搜索框、侧边栏、设置页）完全无视 Alt+Z。
- 检查当前标签页是否高亮（非灰色/半透明），鼠标点入代码区内部再试
- 右下角看语言标识（如
JSON、Markdown），点击它 → “Configure 'JSON' language based settings”，查是否有"editor.wordWrap": "off"—— language-specific 设置优先级高于全局，会直接覆盖Alt+Z的切换效果 -
Alt+Z不作用于只读视图（Git Diff、Search Result），这是设计行为，不是 bug
系统或输入法把 Alt+Z 吞了？这样验证
Windows 下搜狗、百度拼音常把 Alt+Z 当作中英文切换或符号面板唤起键；macOS 辅助功能（如 Zoom 缩放）也可能占用；部分杀软、TeamViewer、录屏工具会全局监听该组合。
- 切到纯英文输入法（
Win+Space或Cmd+Space），再按Alt+Z—— 若此时生效，问题锁定在输入法 - 在记事本或 TextEdit 里按
Alt+Z，看是否弹出响应 —— 若有，说明系统层已注册，VSCode 无法抢回 - 临时退出所有带全局热键的后台软件（尤其 OCR、翻译、远程控制类），再测试
用 Ctrl+K Ctrl+Z 替代是最稳方案
这个 chord 组合键（先按 Ctrl+K 松开，再按 Ctrl+Z）天然避开绝大多数拦截，因为系统级热键极少监听两段式序列，且 VSCode 默认就绑定 editor.action.toggleWordWrap，无需额外配置。
- 注意不是同时按住 —— 是
Ctrl+K→ 松开 →Ctrl+Z - 该组合默认限定在
editorTextFocus条件下，所以终端里无效是正常行为，不影响编辑器使用 - 目前无主流扩展占用此组合（如 GitLens 占用的是
Ctrl+K Ctrl+R），冲突概率极低
非要保留 Alt+Z？必须手动编辑 keybindings.json
图形界面里重绑常失败，因为旧绑定未被清除。唯一可靠方式是精准覆盖：打开命令面板（Ctrl+Shift+P），运行 Preferences: Open Keyboard Shortcuts (JSON)，加一条带严格 when 条件的规则：
[
{
"key": "alt+z",
"command": "editor.action.toggleWordWrap",
"when": "editorTextFocus && !editorReadonly && !inQuickOpen && !terminalFocus"
}
]
重点在 when 条件 —— 显式排除只读、终端、快速打开等干扰场景，才能让 Alt+Z 真正只在编辑器里生效。语言专属设置仍可能覆盖它，这点容易被忽略。
