VS Code预览链接无反应是因系统默认浏览器配置异常或协议关联损坏,需先验证open/xdg-open/start命令是否生效,再检查Live Server的NoBrowser设置、端口占用及协议注册问题。

VS Code 点击预览链接没反应,浏览器根本不启动
不是 VS Code 坏了,大概率是默认浏览器注册表/系统配置被改过,或者 open 命令(macOS/Linux)或 start(Windows)底层调用失败。VS Code 本身不内置浏览器,它只是调用系统命令打开 URL。
- 先在终端手动试一下:
open https://example.com(macOS)、xdg-open https://example.com(Linux)、start https://example.com(Windows),如果这步都打不开,问题一定在系统层 - Windows 用户常见坑:某国产软件(如 QQ、迅雷)静默劫持了
http协议的默认处理程序,导致start调用时无响应或报错The system cannot find the file specified - macOS 用户注意:如果用了
brew install --cask firefox等非 App Store 安装方式,Firefox 可能未正确注册为默认浏览器,open会 fallback 到 Safari —— 但若 Safari 被禁用或损坏,也会静默失败
Live Server 插件点「Go Live」后只弹端口不打开页面
这是 Live Server 的默认行为:它只启动本地服务并输出地址(如 http://127.0.0.1:5500/index.html),是否自动打开浏览器由配置项 liveServer.settings.donotVerifyPort 和 liveServer.settings.AdvanceCustomBrowserCmdLine 控制,但真正起作用的是 liveServer.settings.CustomBrowser 和系统级关联。
- 检查设置里是否误关了自动打开:
liveServer.settings.NoBrowser设为true就完全禁用浏览器启动,设为false或删掉这一项即可 - 想强制指定浏览器?可以填绝对路径,比如 Windows:
"C:\Program Files\Mozilla Firefox\firefox.exe",但注意双反斜杠和空格——路径带空格必须整个用引号包住,且 VS Code 不会帮你校验路径是否存在 - Mac 上填
/Applications/Google Chrome.app是合法的,但填/Applications/Google Chrome.app/Contents/MacOS/Google Chrome反而可能失败:系统级open -a机制认的是 app bundle,不是可执行二进制文件
点开链接后浏览器报 ERR_CONNECTION_REFUSED
这不是浏览器问题,是 VS Code 启动的服务根本没跑起来,或者端口被占。Live Server 默认找空闲端口(5500 起),但如果 5500 被 Python 的 http.server、另一个 VS Code 窗口、甚至 Docker 容器占了,它会换到 5501……但你浏览器里手动敲的还是 5500。
- 看 VS Code 右下角状态栏:Live Server 启动成功后会显示当前地址,比如
http://127.0.0.1:5501—— 一定要以这里为准,别凭记忆敲 - 终端里有没有报错?比如
Cannot assign requested address或EADDRINUSE,说明端口冲突,这时候要关掉其他占用进程,或在settings.json里固定端口:"liveServer.settings.port": 8080 - 某些公司内网环境会拦截
127.0.0.1,但允许localhost;反过来也有,所以如果一个行另一个不行,试试把 URL 里的127.0.0.1换成localhost
改了设置还是没用,怀疑插件缓存或权限问题
VS Code 的 Live Server 插件会缓存上一次启动参数,尤其是工作区级别的 .vscode/settings.json 会覆盖全局设置,而且 macOS/Linux 下如果用 sudo code 启动过,后续普通用户权限下插件可能无法调用系统命令。
- 先关掉所有 VS Code 窗口,再终端执行:
killall -u $USER node(macOS/Linux)或任务管理器结束所有node.exe进程(Windows),清掉残留服务 - 检查项目根目录下有没有
.vscode/settings.json,里面是否有"liveServer.settings.NoBrowser": true这类覆盖项 - macOS 上如果提示
“xxx.app”已损坏,无法打开,不是 VS Code 的问题,是 Gatekeeper 阻止了浏览器启动——去「系统设置 → 隐私与安全性」拉到底部点「仍要打开」,否则 Live Server 调用会静默失败
最麻烦的情况是:浏览器能手动打开,但 VS Code 就是调不动——八成是系统协议关联损坏,这时候别折腾插件,直接修 http 协议默认应用,比改十次配置都管用。










