VSCode默认不软换行是设计使然；临时启用按Alt+Z（Win/Linux）或Option+Z（macOS），仅作用于当前文件；永久生效需在用户settings.json中设"editor.wordWrap": "on"，避免选auto或inherit。
VSCode 默认不软换行，不是漏配，是设计如此；要让长文本（日志、JSON 响应、URL、注释）视觉上折行显示，只改 editor.wordWrap 就够了，不需要动源文件、不插入 \n、不影响 Git 或 Linter。
怎么立刻对当前文件启用软换行（临时查看用）
按一次快捷键就行，不用开设置：
- Windows / Linux：
Alt + Z - macOS：
Option + Z
右下角状态栏会实时显示“换行”或“不换行”。这个操作只作用于当前编辑器标签页，关掉就失效，适合查接口返回体、扫日志、读 Markdown 表格。
常见无效原因：
- 光标焦点不在编辑器主区域（比如停在终端、搜索框、调试控制台里）
- 当前语言被 language-specific 设置覆盖了——点右下角语言标识（如
JSON），选“Configure 'JSON' language settings”，检查是否写了"editor.wordWrap": "off"
怎么让所有文件默认开启软换行（永久生效）
必须改用户级 settings.json，其他路径（如右键菜单、视图菜单）只是会话级开关，重启或切文件就丢。
打开设置（Ctrl + , 或 Cmd + ,）→ 右上角点“Open Settings (JSON)” → 加这行：
"editor.wordWrap": "on"
保存后立即生效。已打开的文件可能需要手动按一次 Alt + Z 刷新渲染。
注意别选这些值：
-
"off"：默认值，必出横向滚动条 -
"auto"：名字有误导性，实际几乎等同于"off"，极少触发 -
"inherit"：行为不可控，容易被插件或工作区配置覆盖
为什么开了 editor.wordWrap 还有横向滚动条
不是配置错了，而是以下三个干扰点在起作用：
-
language-specific设置优先级更高：比如.json、.md、.log文件常被插件（Prettier、Vetur、Rust Analyzer）悄悄设成"editor.wordWrap": "off"，得单独进对应语言配置里改 -
editor.wrappingIndent设为"same"或"indent"时，折行后缩进错位，视觉上像没折——加"editor.wrappingIndent": "none"可验证是否真没生效 - 超长无空格字符串（如 base64、哈希值、连续下划线变量名）在
"on"模式下仍会溢出，因为 VS Code 默认只按空格、/、-等分词点折行
若必须消灭滚动条，且能接受字符级硬切（比如把 a1b2c3d4... 劈成两行），唯一可靠方案是：
{
"editor.wordWrap": "bounded",
"editor.wordWrapColumn": 120
}
软换行和硬换行的根本区别在哪
软换行（editor.wordWrap）只是渲染层处理，不改变文件内容：
- 复制粘贴出来仍是单行
-
git diff显示的仍是原始行号和内容 - ESLint 的
max-len、Prettier 的printWidth完全不受影响 - 终端输出、Markdown 预览、调试面板里也不会带换行
硬换行（比如手动敲 Enter 或运行 editor.action.insertLineBreak）会真实写入 \n，可能破坏 JSON 格式、触发格式化报错、让 Git 认为整行重写。
除非你明确需要提交换行（比如拼接长字符串、写多行注释），否则永远优先用软换行。临时想看原始单行，再按一次 Alt + Z 就能关掉。
最容易被忽略的是：language-specific 设置可以随时覆盖全局配置，哪怕你 settings.json 里写了 "on"，打开一个 .jsonc 文件仍可能不换行——因为 jsonc 是独立语言 ID，得单独配。
