alt+z失效需先确认焦点在编辑器主区域且语言模式正确；右下角状态栏显示“换行”状态，但language-specific设置（如"editor.wordwrap": "off"）会覆盖全局配置；"auto"几乎等同于"off"，应设为"on"；工作区未正确加载或扩展干扰（如prettier）亦会导致失效。
按 Alt+Z 没反应，先确认焦点和语言设置
快捷键 Alt+Z（Windows/Linux）或 Option+Z（macOS）只在编辑器主区域有效。如果光标在搜索框、终端、侧边栏或调试控制台里，它完全不触发——这不是 bug，是设计行为。
右下角状态栏会实时显示“换行”或“不换行”，但前提是当前语言没被单独禁用。点击右下角的语言标识（比如 JSON、Plain Text），选“Configure 'JSON' language settings”，检查里面是否显式写了 "editor.wordWrap": "off"。这类 language-specific 设置优先级高于全局，一写就覆盖。
- 常见错误现象：刚打开一个日志文件，按了
Alt+Z没反应 → 很可能该文件被识别为Log语言，而Log的 language-specific 设置默认关掉了换行 - 临时救急：改完语言设置后，需手动再按一次
Alt+Z才刷新渲染；已打开的文件不会自动重排 - 别指望“改完设置就全局生效”——VS Code 渲染是懒加载的，尤其对已打开的长文件
editor.wordWrap 设为 "on" 还是 "auto"？值选错等于没开
"auto" 不是“智能换行”，它几乎等同于 "off"：只在窗口宽度远小于内容时才折行，日常开发中基本不触发。真正可靠的是 "on"，它按视口宽度实时折行，缩放窗口也会重排。
"wordWrapColumn" 和 "bounded" 要配合 "editor.wordWrapColumn": 120 才起作用，且行为更刚性——比如你设了 80 列，但窗口拉到 200 宽，它仍硬切在第 80 字符，反而破坏阅读节奏。
- 别用
"inherit"：它依赖上层配置，一旦装了格式化插件（如 Prettier）或启用了 Settings Sync，极易被意外覆盖 - 如果换行后第二行顶格难看（比如 JSON 嵌套对象缩进全丢），加一句
"editor.wrappingIndent": "indent"，让软折行继承原行缩进 - 所有这些值都只影响视觉换行，不修改实际文本内容或换行符
.vscode/settings.json 改了但不生效？确认你真在工作区里
VS Code 必须通过 File → Open Folder 打开整个项目目录，.vscode/settings.json 才会被加载。双击单个 .js 文件、或拖拽子文件夹进窗口，VS Code 会降级为“单文件模式”，此时工作区设置完全不读取。
状态栏右下角没有 workspace 或 folder 标识？执行命令面板里的 Developer: Toggle Developer Tools，在 Console 里输入 vscode.workspace.workspaceFolders。返回 undefined 或空数组，说明根本没加载工作区。
- 多根工作区下，
.code-workspace文件的settings字段优先级高于所有子文件夹的.vscode/settings.json - 检查设置 UI 右侧的小图标——它显示当前生效的是“User”、“Workspace”还是“Folder”，比文档更准
- 权限问题常被忽略：macOS 外接磁盘或 Docker 卷挂载的项目，
.vscode文件夹可能因 noexec 或只读被跳过
为什么改了用户 settings.json 还是不换行？查查有没有扩展抢了控制权
某些扩展（尤其是代码格式化类）会绕过 editor.wordWrap，直接操纵编辑器渲染逻辑。典型例子：XML Tools、Prettier、或某些 Markdown 预览增强插件，它们可能强制关闭换行以保证格式化输出对齐。
验证方法很简单：终端运行 code --disable-extensions 启动干净版 VS Code，打开同一文件测试 Alt+Z。如果这时正常了，说明有扩展干扰。
- 不用逐个禁用——先关掉所有格式化/语言服务类扩展（Prettier、ESLint、XML Tools、Auto Rename Tag）
- 注意“启用”状态不等于“正在干预”：有些插件只在特定语言激活时才注入样式规则
- 扩展冲突往往静默发生，不会报错，也不会出现在 Output 面板里
最易被忽略的一点：VS Code 的换行是“软折行”，它不改变文件内容，也不影响复制粘贴行为。如果你在调试时发现 console.log 输出的字符串没换行，那不是编辑器问题，是代码本身没加 \n 或没调用 JSON.stringify(obj, null, 2)。
