如何在WebStorm中设置代码随保存自动换行

WebStorm不支持保存时自动重排长代码换行，仅提供软换行（纯显示）和格式化时的硬换行（需手动启用Reformat on Sa ve或配置Wrapping规则）。

先说一个核心事实：WebStorm 本身并不提供“保存时自动重排代码换行”的功能。换句话说，当你按下 Ctrl+S 时，它并不会主动把那些长长的链式调用或者复杂的条件判断表达式，自动拆分成多行。很多开发者期待的“自动换行”，其实包含了两个截然不同的概念：一个是显示层面的软换行，另一个是格式层面的硬换行。混淆这两者，往往是配置了半天却不见效的根本原因。

Soft-wrap：纯视觉把戏，不碰代码本身

启用软换行后，编辑器里那些超出屏幕宽度的长行，会在视觉上折行显示，让你一眼就能看全。但请注意，这只是一个“显示特效”，文件里存储的代码依然是一整行。这意味着，无论是 Git 的差异对比、git status，还是像 Prettier 这样的格式化工具，都感知不到任何变化。

• 如何开启：路径是 Settings / Preferences → Editor → General → Enable soft-wrap。
• 生效范围：默认只对当前打开的文件有效。如果想对特定类型的文件（比如 *.js, *.ts, *.md）全局生效，需要勾选下方的 Soft-wrap files 并填入对应的通配符。
• Markdown 特例：对于 Markdown 文件，还需要额外开启一个开关：Languages & Frameworks → Markdown → Soft wrap text。否则，文档里的正文段落依然不会折行显示。
• 一个细节：开启软换行后，使用 j/k 键在 Vim 模式下移动时，操作的是视觉行，而非逻辑行。这一点和原生 Vim 的行为不同，你不需要再使用 gj/gk 了。

Hard wrap：真换行，但得靠格式化驱动

我们通常说的“自动换行”，真正起作用的场景是在执行代码格式化时。此时，WebStorm 会依据预设的规则，将超过指定长度的行断开成多行。关键在于，这个动作不会在你每次保存时自动发生，除非你明确配置了相应的保存动作。

• 规则设置核心：前往 Settings / Preferences → Editor → Code Style → [语言] → Wrapping and Braces。
• 关键开关：找到 Wrap if long 选项，这里可以分别控制变量声明、函数调用、二元运算符等不同语法结构是否在过长时换行。
• 长度标准：必须与 Hard wrap at（最大行宽）配合使用。默认是 120 字符，建议根据团队规范调整为 80 或 100。
• 实现“保存即格式化”：这才是实现自动换行的关键一步。需要开启：Settings → Tools → Actions on Sa ve → Reformat code。不过要当心，这会触发全文件重排，可能与项目已有的 Prettier 或 ESLint 规则产生冲突。

Sa ve Actions 下的换行：一场优先级之争

即便你成功开启了 Reformat code on sa ve，最终代码是否换行、如何换行，还可能受到其他因素的制约，这里存在一个优先级问题：

• .editorconfig 优先：如果项目根目录存在 .editorconfig 文件，并且其中设置了 max_line_length 或 wrap_long_lines = true，那么它会优先生效，覆盖 WebStorm 自身的设置。
• Prettier/ESLint 接管：如果你安装了 Prettier 插件并启用了 prettier.enable = true，或者配置了 ESLint 并打开了 eslint.format.enable，那么代码格式化权就会被这些外部工具接管，WebStorm 原生的换行规则将完全失效。
• 动作执行顺序：如果在保存动作中同时勾选了 Optimize imports（优化导入）和 Reformat code，可能会发生一个令人困惑的情况：格式化刚把长行换好，紧接着优化导入又把它们合并回一行。

Markdown 换行：最容易踩的坑

很多开发者遇到过这样的问题：明明开启了全局软换行，但 README.md 里的英文段落还是冲到了屏幕最右边，无法完整显示。这通常是因为：

• 独立开关：Markdown 编辑器的软换行默认是关闭的，而且它的配置开关不在通用的 Editor → General 里，而是藏在 Languages & Frameworks → Markdown 下面，需要单独开启。
• 代码块例外：被 ``` 包裹的代码块内容，是永远不会应用软换行的，这是设计使然，并非软件缺陷。
• HTML 标签限制：如果在 Markdown 中直接使用 HTML 标签（比如

  ）来写段落，软换行对其无效。其显示效果只能依靠后续的 CSS 样式或导出时的渲染引擎来控制。

说到底，真正需要“保存即换行”功能的人，本质是追求格式化的自动化。而如果只是想在不改动代码的前提下看清长行内容，那么配置软换行就足够了。这两者的配置路径、生效时机和覆盖逻辑完全不同，混为一谈只会导致配置反复失效。所以，别再去 Editor → General 里寻找那个根本不存在的“自动换行”按钮了。