WebStorm改Chrome为默认浏览器需同时勾选Active和Default,并填准路径:Windows填chrome.exe全路径,macOS填.app包路径,Linux用which查真实路径,填完必须点Test验证。

WebStorm 默认不走系统默认浏览器,改 Chrome 为默认浏览器的关键是:路径必须精确、Active 和 Default 两个勾选都得打上、Chrome 进程不能冲突——尤其在调试时。
怎么填对 Chrome 的 Path 才不报错
WebStorm 启动 Chrome 失败,90% 是因为 Path 填错了。它不认 alias(比如只写 chrome),也不自动从系统 PATH 查找新版 Chrome(125+ 已移除全局软链)。
- Windows:稳定版填
C:\Program Files\Google\Chrome\Application\chrome.exe;Canary 版填C:\Users\{user}\AppData\Local\Google\Chrome SxS\Application\chrome.exe - macOS:必须填整个
.app包路径,如/Applications/Google Chrome.app;别填Contents/MacOS/Chromium这类二进制路径,WebStorm 不支持 - Linux:优先试
/usr/bin/google-chrome-stable;如果提示Command not found,就用which google-chrome-stable查真实路径再粘贴 - 填完立刻点右侧
Test按钮——它会真启动一次 Chrome,失败就说明路径权限不对或文件不存在
为什么点了 Default 却还是打开旧版 Chrome 或空白页
不是设置没生效,而是 WebStorm 的“默认浏览器”逻辑有两层开关:必须同时满足 Active + Default,缺一不可。
- 进
Settings → Tools → Web Browsers and Preview,找到 Chrome 行,左侧Active和右侧Default都要勾选 - 如果列表里有多个 Chrome(比如 Stable + Canary),确保只有一个勾了
Default;否则 WebStorm 会按列表顺序取第一个 Active 的 - 右键 HTML 文件 →
Open in Browser或按Alt+F2才走这个 Default;但Debug模式另算——它只认你 Debug 配置里指定的浏览器,和 Default 无关
Chrome 调试时老连不上?先关掉所有 Chrome 窗口
WebStorm 调试依赖 Chrome 的 --remote-debugging-port,而 Chrome 只允许一个实例监听该端口。你日常开着的 Chrome 已占着端口,WebStorm 就只能连失败。
- 任务管理器(Windows)或活动监视器(macOS)里杀掉全部
chrome进程,再点Debug,它才能起一个干净的调试实例 - 不想关日常 Chrome?改用
Attach to Chrome模式:手动终端执行google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug,然后 WebStorm 配置里 URL 填项目实际地址(如http://localhost:5173),Port 填9222 - Vue/Vite 项目务必关掉自动开浏览器:
vite.config.ts里加server: { open: false },否则它会抢在 WebStorm 之前用非调试 Chrome 打开页面
最易被忽略的是:WebStorm 的 Default 浏览器只影响预览(Open in Browser),不影响 Debug;而 Debug 又高度依赖 Chrome 实例是否干净、URL 是否匹配开发服务器真实端口——这两套机制互不干扰,但常被当成一回事处理。


















