WebStorm需手动开启软换行:进入Settings/Preferences→Editor→General,勾选Enable soft-wrap;Markdown需额外在Languages & Frameworks→Markdown中启用Soft wrap text。

WebStorm 默认不开启软换行,必须手动打开,否则长代码行会水平滚动,看不全也不方便审查。
怎么在编辑器里开启软换行
软换行(Soft Wrap)是纯显示行为,不改变实际换行符,只让长行在编辑器里自动折行显示。它不是保存时插入 \n,也不会影响 Git diff 或格式化结果。
- 打开
Settings / Preferences(macOS 是Cmd + ,,Windows/Linux 是Ctrl + Alt + S) - 进入
Editor > General - 勾选
Soft-wrap files下方的Enable soft-wrap - 如需对特定文件类型启用,可在下方
Soft-wrap files输入框填后缀,例如:*.js, *.ts, *.md
注意:这个设置是全局生效的,但可以被具体语言的设置覆盖(比如 Markdown 有独立的软换行开关)。
Markdown 文件里软换行不生效?检查这个开关
WebStorm 对 Markdown 单独维护了一套渲染逻辑,即使全局开了软换行,.md 文件仍可能不折行——因为它的「软换行」开关默认关闭且藏得深。
- 进
Settings / Preferences > Languages & Frameworks > Markdown - 找到
Soft wrap text选项并勾选 - 该设置只影响预览窗和编辑器中的文本段落(非代码块),代码块永远不软换行
常见现象:写文档时英文段落一整行顶到右边看不见,复制出来却没换行——就是这个开关没开。
为什么改了设置还是不换行?排查这三点
软换行看似简单,但容易被其他设置压制或误判为“失效”。
- 当前文件是否被加入
Soft-wrap files列表?比如你只写了*.ts,但正在编辑的是index.jsx,就不会生效 - 是否启用了
Editor > Color Scheme > General > Line numbers的「Show line numbers」?它本身不影响软换行,但若同时开了「Highlight current line」+ 长行+高亮色块,视觉上会误以为没折行 - 有没有装冲突插件?比如
Visual Studio Code Keymap插件偶尔会重置编辑器渲染策略;可临时禁用插件验证
最直接的验证方式:打开一个超长字符串(比如 Base64 编码),把窗口缩窄,看是否自动断成多行显示——而不是出现水平滚动条。
软换行本质是 UI 层的视觉适配,不是代码逻辑的一部分。很多人调了半天发现「好像没用」,其实是忘了它只作用于编辑器视图,不改变任何实际内容,也不参与编译、格式化或提交。真要让代码换行,得靠 Prettier 或 ESLint 的 max-len 规则,那是另一回事了。










