Linux系统VS Code调试Chrome时“无法启动浏览器”报错的解决方法

核心问题：VS Code找不到你的Chrome浏览器安装路径，哪怕你觉得已配置，大概率是路径不对或配置存在疏漏。

步骤1：获取Chrome的绝对安装路径 #

打开终端，执行以下命令之一，得到浏览器的绝对路径：

• 若安装的是Google Chrome：which google-chrome
• 若安装的是Chromium：which chromium-browser
• 上述命令无输出时，用搜索定位：find / -name google-chrome 2>/dev/null

执行后会得到类似/usr/bin/google-chrome或/snap/bin/google-chrome（Snap安装场景）的路径，记好这个路径。

步骤2：修正launch.json配置 #

打开VS Code左侧调试图标，点击顶部齿轮图标打开launch.json文件，确保Chrome调试配置中包含runtimeExecutable字段，且值为你刚获取的绝对路径。示例配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "chrome",
            "request": "launch",
            "name": "Launch Chrome",
            "url": "http://localhost:5500", // 填写你要调试的页面URL，比如本地静态服务地址
            "webRoot": "${workspaceFolder}",
            "runtimeExecutable": "/usr/bin/google-chrome" // 替换为你找到的实际路径
        }
    ]
}

常见错误排查 #

• 必须使用绝对路径，不能只写google-chrome或相对路径
• 区分Chrome与Chromium：多数Linux发行版默认安装的是Chromium，别混淆路径
• 注意路径大小写：Linux路径区分大小写，比如Google-Chrome和google-chrome是不同路径
• 若通过Snap商店安装Chrome，路径通常为/snap/bin/google-chrome，需填写此路径

验证配置 #

保存launch.json后重启VS Code，再尝试启动调试，即可正常打开Chrome进行调试。

内容的提问来源于stack exchange，提问作者kbb