WebStorm软换行是仅影响显示的软换行，需在Settings→Editor→General中勾选Use soft wraps in editor；若未生效，需检查文件类型是否匹配Soft wrap files列表、.editorconfig冲突或Vim插件干扰。
WebStorm 的“自动换行”本质是软换行（soft wrap），它不修改源码，只改变显示方式；真要拆分代码行必须靠格式化（Reformat Code）或手动回车。
怎么开启编辑器软换行（视觉上换行）
软换行让超长行在编辑器里折成多行显示，避免横向滚动条，但不会插入 \n 或改变实际文件内容。
- 打开
File → Settings → Editor → General（macOS 是WebStorm → Preferences → Editor → General） - 勾选
Use soft wraps in editor - 若只想对特定类型文件启用，填入
Soft wrap files列表，例如：*.md; *.txt; *.log—— 注意：不填则全局生效，但*.*可能导致 JSX/TSX 文件换行错乱，慎用 - 改完后需重新打开文件或切换标签页，部分旧文件可能缓存未刷新
为什么开了软换行，代码还是不换？重点查这三处
常见“看似没生效”，其实是被更高优先级配置压制了：
- 当前文件扩展名不在
Soft wrap files白名单中（比如你只写了*.js，却在编辑index.tsx） - 项目根目录存在
.editorconfig，且含max_line_length = off或wrap_attributes = "preserve"等字段，会覆盖 WebStorm 的软换行行为 - 启用了
Save Actions插件，并勾选了Reformat code，但该操作本身不触发软换行——它只影响真实换行符，和Use soft wraps无关
怎么让代码真正断行（写入换行符）
软换行只是显示层，如果想把一行超长的函数调用、对象字面量或 JSX 拆成多行并保存到文件里，得靠格式化：
- 快捷键
Ctrl + Alt + L（Windows/Linux）或Cmd + Option + L（macOS）执行Reformat Code - 确保对应语言的 Code Style 设置已启用换行规则：比如在
Settings → Editor → Code Style → JavaScript中，Wrapping and Braces → Function call arguments设为Wrap if long - 注意：格式化是否生效，取决于光标所在位置的语言上下文。在注释里按
Ctrl + Alt + L不会动代码；在 JSX 标签内，需确认Code Style → HTML → Wrap attributes已设为合适策略
软换行下的 Vim 模式移动逻辑变化
启用 Use soft wraps in editor 后，Vim 插件的行为会变：
- 默认
j/k移动的是“视觉行”（即软换行后的每一小段），不是逻辑行——这点和原生 Vim 不同，但 WebStorm 做了适配，所以无需再记gj/gk - 但如果同时开了
Settings → Editor → Vim Emulation → Use IdeaVim（独立插件），而没关掉 WebStorm 自带的软换行支持，两者可能冲突，表现为光标跳转错位 - 验证是否真软换行：粘贴一段 300 字符的 Base64 字符串，缩窄编辑器宽度，看是否自动折行显示；若仍横向滚动，说明软换行根本没生效
软换行开关本身简单，但实际效果常被 .editorconfig、文件类型匹配、Vim 插件或 Save Actions 干扰。排查时优先确认当前文件是否在软换行白名单里，再看有没有外部配置劫持了行为。
