phpstorm默认开启括号自动配对,若失效需检查smart keys中insert pair bracket是否启用,路径为file→settings或phpstorm→preferences→editor→general→smart keys,该选项控制()、[]、{}及的自动补全。

PhpStorm 默认就开启括号自动配对,但如果你发现输入 (、{、[ 或 后没有自动补全右半边,大概率是设置被关了,或者被省电模式抑制了。
检查 Smart Keys 里的 Insert pair bracket 是否启用
这是最核心的开关。它控制所有成对符号的基础行为,包括 ()、[]、{} 和 :
- 路径:
File → Settings(Windows/Linux)或PhpStorm → Preferences(macOS),再进Editor → General → Smart Keys - 必须勾选
Insert pair bracket;不勾选则所有括号都不会自动配对 - 如果只想要
()自动补全但不想影响[]或{},注意:PhpStorm 不提供按符号粒度开关,它们共用这一个选项 - HTML 标签的
<div> 补全也依赖此项,但还需配合后续的标签补全设置 <h3>确认 Auto-close tag on typing '' 已启用(HTML/XML 场景)</h3> <p>仅当编辑 HTML、Vue、Blade 等含标签的文件时才需要关注这个细节。它决定你输入 <code>后是否自动补全闭合标签:- 同样在
Editor → General → Smart Keys页面底部 - 勾选
Auto-close tag on typing '',否则不会触发任何补全 - 注意:该功能只响应
开头的输入,不是所有都会触发——比如输入 <code><di> 后按 Tab 才会补全成 <code><div></div>,这属于另一套「标签完成」逻辑 - 若想让
<div> 直接变成 <code><div></div>,需额外确保Insert pair tag(在同页 HTML/CSS 区域)也被勾选排除 Power Save Mode 干扰
省电模式会全局禁用所有智能辅助,包括括号配对、代码补全、实时错误提示等,且界面无明显警告:
- 看右下角状态栏:是否有
Power Save Mode字样或电池图标 - 点击该区域 → 取消勾选
Power Save Mode - 关闭后无需重启,括号配对会立即恢复(但 Rainbow Brackets 类插件仍需重启)
- 常见诱因:笔记本拔掉电源后 IDE 自动进入,或误点右下角齿轮菜单中的开关
为什么单引号/双引号总多出一个?
这不是配对失效,而是
Surround selection on typing quote or brace在起作用——你选中了一段文本,再按',它会自动包裹成'text',而非只加左边一个引号:- 若你不需要这种“包围”行为,去
Editor → General → Smart Keys取消勾选Surround selection on typing quote or brace - 若只想禁止单引号配对但保留括号,取消勾选
Insert pair quote即可 - 临时绕过:不选中文本,直接把光标放在字符串前/后,再按
',就不会触发包围逻辑
括号配对本身不依赖文件类型识别,但 Rainbow Brackets 插件、PHP 命名空间解析、HTML 标签补全这些高级功能,都要求右下角状态栏显示正确的文件类型(如 PHP、HTML)。如果显示的是
Text,先右键文件 →Override File Type→ 选对语言,否则很多配套行为会静默失效。 - 看右下角状态栏:是否有
- 同样在










