WebStorm快捷键之自动补全分号，细节操作也高效

说白了，WebStorm 之所以不自动给你加分号，是因为它压根儿就没设计成边写边补。它的逻辑很简单：要么你通过格式化（Ctrl+Alt+L）批量补上，要么你手动按个分号。至于什么时候补、怎么补，还得看“Semicolon to terminate statements”这个设置，以及项目里有没有 Prettier、ESLint 这些外部工具——它们经常插一腿，悄悄改掉你的习惯。

WebStorm 为什么写完语句不自动加分号

它从一开始就没打算让你“边写边加”。所有分号自动插入的开关默认都是关的，唯一一个叫 Semicolon to terminate statements 的选项，只管格式化时补不补分号，跟实时输入完全没关系。来看看具体是怎么一回事：

• Semicolon to terminate statements = always 只控制 Ctrl+Alt+L 格式化时的行为——你敲完 const a = 1 后摁一下回车，它是不会自动补的。
• 就算你开了 Insert semicolon at end of line when typing，也只有当光标紧贴在行末、并且当前行是一个完整语句（比如 let x = 2）时，按 Enter 才会生效。这条件够苛刻吧？
• 举个例子：补全 $.ajax({}) 后，光标会停在括号里。WebStorm 觉得这不是语句终点，所以你再怎么按 Enter，分号就是不出来——这是它的判断逻辑，不是 bug。
• Postfix 补全（比如 a != null 后打点选 ?.let）也不参与分号插入，它只管生成新结构，不碰语句边界。

怎么让 Ctrl+Shift+Enter 补全时带分号

这个快捷键本身不负责加分号，它的任务是“把不完整的语句补成合法的语法结构”：比如补大括号、补 return、补 if 结构。至于补完后带不带分号，就看你有没有把 Semicolon to terminate statements 设成 always。

• 写 return x → 按 Ctrl+Shift+Enter → 如果前面设成了 always，就会补成 return x;
• 写 if (x) → 按快捷键 → 补成 if (x) { }，光标自动进花括号，不加分号（因为 if 本身不需要分号）
• 写 function foo() → 同样补成花括号，不分号
• 要是补完后还是没分号，先检查一下 Settings → Editor → Code Style → Ja vaScript → Punctuation 里的设置是不是真的 always，而不是 never 或 semicolons required

EditorConfig 和 Prettier 会悄悄关掉你的分号设置

只要项目根目录下有个 .editorconfig，或者你开了 Prettier/ESLint 的“保存时自动格式化”，WebStorm 原生的分号设置基本就作废了——这些外部工具优先级更高，根本不读 WebStorm 的配置。

• .editorconfig 文件里写 semi = true 其实是 ESLint 风格的写法，WebStorm 压根不识别。真正起作用的是 Prettier 的 semi: true 或 ESLint 的 semi: ["error", "always"]。
• 想验证是不是被接管了？临时关掉 Settings → Tools → Prettier / ESLint 里的“Run on sa ve”，再试一次 Ctrl+Alt+L，看看分号会不会出现。
• 如果用 Prettier，必须在 .prettierrc 里显式写上 "semi": true，否则即便 WebStorm 设了 always，保存时还是会被删掉分号。
• 别指望 .editorconfig 来控制分号——它只管缩进、换行符、空格这些基础格式，对分号无感。

补全后想立刻加分号？别等 Enter，直接按 ;

最稳的办法不是等自动逻辑，而是自己动手——但不是盲打，而是利用 WebStorm 的“智能分号插入”：它只在合法位置插入，不会破坏语法。

• 补全 console.log("hello") 后，光标停在右括号里 → 按 End 到行尾 → 按 ; → 分号自动出现在合法位置，光标跳到分号后，不打断你的输入流。
• 写 const a = 1 后光标停在 1 后面 → 直接按 ; → 补成 const a = 1;，光标也停在分号后。
• 这个行为不依赖任何设置，是编辑器底层的语法感知能力，比等 Enter 触发更稳、更快。
• 注意：如果按 ; 后没反应，说明当前光标位置不被识别为语句结尾（比如在对象字面量里），这时得先完成结构再补。

分号插入的行为完全依赖 WebStorm 对“语句完整性”的实时判断——而这个过程在补全、Postfix、甚至部分格式化场景下都不可见、不可控。真正能稳定干预的，其实只有三件事：把 Semicolon to terminate statements 设成 always、关掉外部格式化插件，以及养成补全后直接按 ; 的肌肉记忆。