VSCode终端换行需设terminal.integrated.wordWrap为"on"，仅影响单行超宽输出；常见无效原因包括命令无换行符、字体编码问题或TUI工具干扰；刷屏问题多因屏幕阅读器模式误启；长文本建议用编辑器打开或管道处理。
VSCode终端本身不支持软换行（soft wrap），所谓“无法换行”不是配置错了，而是你试图用编辑器的 editor.wordWrap 去控制终端输出——这条路根本走不通。
terminal.integrated.wordWrap 必须设为 "on"
终端面板有自己独立的换行开关，和编辑器设置完全无关。它只影响终端里命令输出的**单行超宽内容是否自动折到下一行显示**（比如超长 git log --oneline 或 npm ls 结果）：
-
terminal.integrated.wordWrap默认是"off"，所以长行直接横向溢出、被截断或触发水平滚动 - 必须手动设为字符串
"on"（不是true，也不是"true"），值写错就无效 - 修改后无需重启 VSCode，但已打开的终端标签页要关闭重开才生效
- 该设置对所有新终端生效，包括 PowerShell、bash、zsh 等任何 shell
为什么开了 wordWrap 还是不换行？检查这三点
常见假性失效，其实不是设置没起作用，而是被其他机制覆盖或干扰：
- 命令本身没输出
\n—— 终端换行靠的是程序输出的换行符，不是渲染层自动切。例如echo -n "a very long line without newline"就永远是一行，terminal.integrated.wordWrap拿它没辙 - 终端字体缺失或编码异常 —— 中文路径/日志显示为
???或堆叠成单行，本质是 UTF-8 未启用或等宽中文字体未加载。检查terminal.integrated.fontFamily是否包含"Fira Code"、"Consolas"或"monospace" - 某些 TUI 工具（如
htop、less -S）退出后会重置终端状态，导致后续输出渲染错乱；临时改用cat file.log | fold -w 120可绕过
终端刷屏、疯狂换行？先关屏幕阅读器模式
一打开终端就自动不停向下滚动、每秒多出几行空行，这不是换行问题，而是 Accessibility 模式误触发：
- 按
Ctrl+Shift+P→ 输入Toggle Screen Reader Accessibility Mode→ 回车执行一次 - 该命令会切换屏幕阅读器兼容模式，开启后终端会强制高频刷新，表现为“自动换行刷屏”
- 执行后关闭当前终端，再按
Ctrl+`重新打开即可恢复正常 - 这个坑在更新后或装了远程开发插件时高频出现，比改配置快十倍
真正需要“长文本可读”的场景，别硬刚终端
如果你常要看 JSON、日志、diff 输出，终端终究不是最佳载体：
- 把文件拖进编辑器里打开，它受
editor.wordWrap控制，且可配"[json]": {"editor.wordWrap": "wordWrapColumn"} - 命令输出重定向到文件：
npm run build --verbose > output.log，再用编辑器打开output.log - 用管道加工：
git diff | less -S（-S禁止换行）、cat huge.json | jq '.'（格式化）、echo "$URL" | fold -w 80
终端的定位是交互式命令执行环境，不是文档阅读器。强行让它承担排版任务，只会反复掉进配置陷阱。
