WebStorm不支持保存时自动重排长代码换行，仅提供软换行（纯显示）和格式化时的硬换行（需手动启用Reformat on Save或配置Wrapping规则）。
WebStorm 本身不提供“保存时自动重排代码换行”的功能——它不会在你按下 Ctrl+S 时，把原本写在一行的长表达式（比如链式调用、长条件判断）自动拆成多行。所谓“自动换行”，实际分两类：显示层软换行（soft wrap）、格式层硬换行（wrapping on reformat）。用户常混淆二者，导致设置后没效果。
Soft-wrap 是纯显示行为，不影响代码内容
启用后，超长行在编辑器里视觉上折行，但文件里仍是单行，Git diff、git status、prettier 都看不到变化。
- 路径：
Settings / Preferences → Editor → General → Enable soft-wrap - 只对当前打开的文件生效（除非勾选下方
Soft-wrap files并填入*.js, *.ts, *.md等通配） - Markdown 文件需额外开启：
Languages & Frameworks → Markdown → Soft wrap text（否则正文段落仍不折行） - 软换行后，
j/k移动的是视觉行（不是逻辑行），这点和 Vim 原生行为不同，无需gj/gk
Hard wrap（真换行）必须靠格式化触发，不是保存自动发生
WebStorm 的「自动换行」真正起作用的场景，是执行代码格式化（reformat）时，按预设规则把长行断开。它不会在普通保存时运行，除非你手动启用了 Save Actions。
- 核心设置在：
Settings / Preferences → Editor → Code Style → [语言] → Wrapping and Braces - 关键开关：
Wrap if long（对变量声明、函数调用、二元运算符等分别控制） - 必须配合最大行宽：
Hard wrap at（默认 120，建议设为 80 或 100，和团队规范对齐） - 若想保存即格式化，请开启：
Settings → Tools → Actions on Save → Reformat code（注意：这会全量重排，可能和 Prettier/ESLint 冲突）
Save Actions 下的换行行为容易被覆盖
即使开了 Reformat code on save，最终是否换行，还取决于三件事谁说了算：
-
.editorconfig中的max_line_length或wrap_long_lines = true会优先生效 - 已安装的 Prettier 插件若启用了
prettier.enable = true，会接管格式化，WebStorm 原生设置失效 - ESLint +
eslint.format.enable同样会绕过 WebStorm 的 wrapping 规则 - 顺序问题：
Optimize imports和Reformat code若同时开启，导入整理可能把刚换好的行又挤回一行
Markdown 中的换行最易踩坑
很多人以为开了全局 soft-wrap，README.md 就该自动折行，结果英文段落还是顶到右边看不见——这是因为：
- Markdown 编辑器默认关闭
Soft wrap text，且该开关不在Editor → General，而在Languages & Frameworks → Markdown - 代码块（
```包裹的内容）永远不 soft-wrap，这是设计使然，不是 bug - 如果文档里用 HTML 标签（如
<p>）写段落，软换行对其无效，只能靠 CSS 或导出渲染控制
真正需要“保存即换行”的人，本质要的是格式化自动化；而只想让长行看得全，就只需 soft-wrap。两者配置路径、生效时机、覆盖逻辑完全不同，混用只会反复失效。别在 Editor → General 里找“自动换行”按钮——它根本不存在。
