WebStorm的自动换行分软换行（Soft Wrap）和代码风格级换行（Wrap if long）两类：前者仅影响显示，不修改文件内容；后者通过格式化真实插入换行符。
WebStorm 的“自动换行”实际分两类：软换行（Soft Wrap）纯属编辑器显示行为，不改代码；而代码风格级的换行（Wrap if long）会真实插入换行符并影响格式化结果。两者常被混为一谈，但开关位置、生效时机、适用场景完全不同。
Editor → General 里的 Soft-wrap 是最常用的软换行
这是你缩窄窗口后长行不出现水平滚动条的关键设置，只影响眼睛，不改文件内容。
- 打开
Settings / Preferences（Win/Linux:Ctrl + Alt + S，macOS:Cmd + ,） - 进入
Editor → General - 勾选
Enable soft-wrap - 若只想对特定类型生效，在下方
Soft-wrap files输入框填后缀，例如：*.md, *.log, *.txt
注意：Markdown 文件需额外开启 Languages & Frameworks → Markdown → Soft wrap text，否则全局开了也不生效——它走的是独立渲染通道，代码块永远不软换行。
Code Style 设置里的 Wrap if long 才真正改变代码
这个设置控制 Prettier 或 WebStorm 自带格式化器（Reformat Code）在保存或手动触发时是否把过长语句断成多行，比如链式调用、对象字面量、二元运算等。
- 路径是：
Editor → Code Style → [语言，如 JavaScript / TypeScript] → Wrapping and Braces - 关键选项：
Wrap if long（全局开关）、Binary operations、Method call arguments、Chained method calls - 必须配合
Right margin (columns)使用，比如设为80或120，否则“过长”无判定依据
常见误操作：只开了 Wrap if long 却没设 Right margin，结果格式化完全不换行；或者开了 Soft-wrap 就以为代码已“被换行”，结果提交后 Git diff 里还是单行长行。
为什么改了设置还是没换行？重点排查这三点
软换行和代码换行都可能“看似失效”，但原因不同：
- 当前文件没匹配
Soft-wrap files列表（比如你只写了*.ts，却在编辑index.jsx） - 项目根目录存在
.editorconfig，且含max_line_length = off或wrap_attributes = "preserve"等覆盖项，会压制 WebStorm 的 Code Style 设置 - 启用了
Save Actions（如「Reformat code」+「Optimize imports」），但末尾换行（Ensure line feed at file end on Save）不是最后执行项，可能被前面操作覆盖
验证软换行是否真生效：粘贴一段超长 Base64 字符串，缩窄编辑器宽度，看是否断成多行显示而非横向滚动；验证代码换行是否生效：写一个 150 字符的函数调用，按 Ctrl + Alt + L（Reformat Code），观察是否被拆开。
Markdown 和日志类文本建议单独配软换行
这类内容天然不适合硬换行（比如段落、URL、错误堆栈），但又需要可读性，软换行是最轻量的解法。
- 全局启用
Enable soft-wrap后，在Soft-wrap files加上：*.md, *.log, *.txt, *.csv - 务必进
Languages & Frameworks → Markdown勾选Soft wrap text，否则预览和编辑器里英文段落仍是一整行顶到右边 - 别对
*.js或*.ts开软换行——代码逻辑行不该靠视觉折行来阅读，容易干扰括号匹配、调试跳转和 Vim 模式下的j/k移动
软换行只是 UI 层妥协，不是代码规范。真要约束行宽，靠 Code Style → Right margin + 格式化动作；真要统一换行符，靠 Ensure line feed at file end on Save 或 .editorconfig 的 insert_final_newline = true。把这两层混着调，八成会互相打架。
