软换行有两种启用方式：右键gutter勾选仅当前文件生效；settings中启用并填写后缀规则（如.js, .md）才全局持久生效，需注意语言专属设置覆盖、缩放影响及bom解析问题。
软换行开关在哪？两种方式都有效，但作用范围不同
WebStorm 的软换行（Soft Wrap）不是“开一次就全局永久生效”的单一开关，它分「当前文件临时启用」和「按规则全局启用」两种路径，选错会导致你以为设好了，其实没生效。
- 右键编辑器左侧 gutter（行号区域）→ 勾选
Soft-Wrap：只对当前文件生效，关闭再打开就恢复原状，适合临时看长日志或 JSON - 进入
Settings / Preferences→Editor > General→ 勾选Enable soft-wrap，并在下方Soft-wrap files输入框填匹配规则：这才是持久化设置 - 注意：
Soft-wrap files默认为空，不填任何内容 = 不对任何文件启用软换行，哪怕你勾了上面的总开关
怎么写 Soft-wrap files 规则？别用 *.*，优先用具体后缀
*.* 看起来省事，但实际会覆盖语言专属设置（比如 Markdown 有自己的软换行开关），还可能让编译器输出、console 日志等非源码文件也强制换行，干扰阅读。
- 推荐写法：
*.js, *.ts, *.jsx, *.tsx, *.md—— 明确限定常用源码和文档类型 - 想对所有文本类文件启用：
*.txt, *.log, *.csv, *.json，比*.*更安全 - 路径通配符不支持嵌套目录，
src/**/*.ts这种写法无效，只认文件后缀 - 多个规则用英文逗号+空格分隔，末尾不要加逗号，否则可能被识别为一个带空格的扩展名
启用了还是不换行？检查这三个地方
常见现象是设置保存了、重启了、也勾了选项，但超长代码行依然横向滚动。大概率卡在这三处：
- 当前文件类型被语言专属设置覆盖：比如 Markdown 文件，即使你在通用设置里写了
*.md，也要额外确认Settings > Editor > Languages & Frameworks > Markdown > Preview里的Soft wrap text是否开启 - 编辑器缩放过大：字体太大时，软换行触发阈值变高，看起来像没生效；可尝试
Ctrl + 鼠标滚轮缩小字号验证 - 文件编码或 BOM 导致解析异常：极少数情况下，含 BOM 的 UTF-8 文件会让 WebStorm 误判文件类型，导致规则不匹配；用其他编辑器另存为无 BOM UTF-8 再试
软换行影响 Vim 模式操作吗？j/k 行动逻辑变了
启用软换行后，视觉上一行代码被折成多行，但 Vim 模式下 j/k 默认仍按逻辑行移动（即跳到上/下一个 \n），不是视觉行。这点容易误判为“换行失效”或“光标卡住”。
- 想按视觉行上下移动：用
gj/gk（注意是小写 g + j/k） - 但 WebStorm 的 Vim 插件默认已优化此行为：只要启用了
Use Soft Wraps（即 gutter 右键勾选的那个），j/k就自动按视觉行走，无需加g - 如果发现没生效，检查是否安装了冲突的 Vim 插件（如 VSCodeVim 类似插件），或在
Settings > Plugins中禁用非官方 Vim 扩展
