1. 重装系统后 Live Server 打不开浏览器，先别急着重装插件
如果你在 VSCode 里写完 HTML，点一下右下角 Go Live，结果浏览器纹丝不动，或者弹出一个空白页，又或者控制台甩出一句command 'extension.liveServer.goOnline' not found，那这篇排查清单就是给你准备的。Live Server 和 open in browser 这两个插件，本质上干的是同一件事：把本地文件通过一个临时 HTTP 服务暴露出来，再调用系统默认浏览器打开对应地址。听起来简单，但它同时踩了三个容易出问题的环节——端口、浏览器关联、插件自身状态。任何一个环节断了，表现都是“点了没反应”。
我见过太多人一上来就卸载重装 VSCode，其实大可不必。重装系统后出现这类问题，大概率是账户同步把旧路径的配置带了过来，而新系统的用户目录、浏览器安装路径、端口占用情况都变了。你需要的是按顺序排查，而不是碰运气。下面我会按端口占用、默认浏览器关联、插件配置三条线逐一拆解，每条线都给出可复制的命令和配置片段，以及每步的验证动作。你跟着做，基本能在十分钟内定位到是插件配置问题还是系统关联问题。
先明确一下适用人群：前端初学者、用 VSCode 写静态页面的同学、以及刚重装完系统发现插件集体失灵的人。核心检索词就是 VSCode Live Server 无法打开浏览器、open in browser 无响应、端口占用排查。这三个词贯穿全文，你遇到的现象基本都能对应上。
2. 端口占用排查：Live Server 默认 5500 端口被谁吃了
Live Server 默认监听 5500 端口，open in browser 走的是文件路径直接打开，但如果你用的是 Live Server 的 Go Live，端口被占用是最常见的“点了没反应”原因之一。表现是：VSCode 右下角弹出一个小提示，说端口已被占用，或者干脆静默失败，浏览器打开一个http://127.0.0.1:5500但页面一直转圈。
2.1 用命令行确认 5500 端口状态
Windows 下打开 PowerShell 或 CMD，执行：
netstat -ano | findstr :5500如果输出类似下面这样，说明端口确实被占用了：
TCP 127.0.0.1:5500 0.0.0.0:0 LISTENING 12345最后一列的12345就是占用该端口的进程 PID。你可以用任务管理器找到它，或者直接：
tasklist | findstr 12345macOS 或 Linux 下用：
lsof -i :5500如果没有任何输出，说明 5500 是空闲的，那问题不在端口占用，继续往下看。
2.2 改掉 Live Server 的默认端口
与其去杀进程，不如直接给 Live Server 换一个不常用的端口。打开 VSCode 设置，搜索liveServer.settings.port，把它改成 5501 或 8080 之类。更推荐直接写进settings.json，这样同步账户时也能带走：
{ "liveServer.settings.port": 5501, "liveServer.settings.CustomBrowser": "chrome", "liveServer.settings.donotShowInfoMsg": true }改完之后，重新点 Go Live，观察右下角状态栏是否显示Port: 5501。如果显示的还是 5500，说明配置没生效，检查一下你是不是改在了工作区设置而不是用户设置里。
2.3 验证端口是否真的换了
改完端口后，在浏览器手动访问http://127.0.0.1:5501，如果能看到你的 HTML 页面，说明 Live Server 服务本身是正常的，问题只出在“自动打开浏览器”这一步。这一步的验证很关键，它能帮你把“服务起不来”和“浏览器打不开”两个问题彻底分开。
我试过在重装系统后遇到 5500 被某个后台服务占用，Live Server 静默失败，状态栏连提示都没有。后来把端口改成 5501 就恢复了。所以端口这条线，先查再改，别跳过。
3. 默认浏览器关联：open in browser 为什么调不起 Chrome
open in browser 插件的行为和 Live Server 不同，它不启动 HTTP 服务，而是直接用系统默认浏览器打开当前 HTML 文件的file://路径。如果系统默认浏览器关联坏了，或者插件配置里指定的浏览器路径不对，就会出现“点了没反应”或者“打开一个空白页”。
3.1 检查系统默认浏览器关联
Windows 下打开“设置 → 应用 → 默认应用”，找到“Web 浏览器”，确认它指向的是你实际安装的 Chrome 或 Edge。重装系统后，有时候默认浏览器会被重置成 Edge，而你的 open in browser 插件配置里写的是 Chrome 的旧路径，两边对不上，就会失败。
macOS 下在“系统设置 → 桌面与程序坞 → 默认网页浏览器”里检查。
3.2 open in browser 的配置片段
open in browser 插件支持在settings.json里指定浏览器。以 Chrome 为例，Windows 下路径通常是：
{ "open-in-browser.default": "chrome", "open-in-browser.chromePath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe" }macOS 下则是：
{ "open-in-browser.default": "chrome", "open-in-browser.chromePath": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" }注意路径里的反斜杠要写成双反斜杠，这是 JSON 的转义要求。如果你写的是单反斜杠，配置会解析失败，插件就会回退到系统默认浏览器，表现就是“我明明配了 Chrome，它却用 Edge 打开”。
3.3 验证浏览器路径是否正确
在终端里直接执行你配置的那个路径，看能不能启动浏览器：
& "C:\Program Files\Google\Chrome\Application\chrome.exe" --version如果提示找不到文件，说明路径写错了，去 Chrome 的安装目录下确认一下实际文件名。这一步能排除掉“路径拼写错误”这种低级但高频的问题。
3.4 Live Server 的 CustomBrowser 配置
Live Server 也有类似的浏览器指定项，叫liveServer.settings.CustomBrowser，可选值有chrome、firefox、edge等。如果你系统里装了多个浏览器，建议显式指定，避免它去调用一个不存在的默认浏览器：
{ "liveServer.settings.CustomBrowser": "chrome", "liveServer.settings.AdvanceCustomBrowserCmdLine": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe" }AdvanceCustomBrowserCmdLine是给高级用户用的，可以传完整的命令行参数。如果你只是想让 Chrome 打开，用CustomBrowser就够了。
4. 插件配置与重装：command not found 的真正解法
如果你在 VSCode 里看到command 'extension.liveServer.goOnline' not found，那说明 Live Server 插件本身没有正确加载。这个报错和端口、浏览器都无关，是插件安装状态的问题。重装系统后通过账户同步插件，很容易出现扩展包损坏或路径失效。
4.1 先确认插件是否真的启用了
打开 VSCode 扩展面板，搜索 Live Server，看它是不是显示“已启用”。如果显示“已禁用”或者“需要重新加载”，点一下启用，然后按Ctrl+Shift+P执行Developer: Reload Window。很多时候同步过来的插件处于半安装状态，重新加载窗口就能恢复。
4.2 删除扩展包再重装
如果重新加载无效，就按下面步骤来。先完全关闭 VSCode，然后找到扩展安装目录：
Windows 下是：
C:\Users\你的用户名\.vscode\extensions\macOS 和 Linux 下是：
~/.vscode/extensions/在这个目录里找到名字类似ritwickdey.liveserver-5.7.9的文件夹，把它整个删掉。然后重新打开 VSCode，在扩展面板里重新安装 Live Server。这一步能解决绝大多数command not found的问题，因为同步过来的扩展包可能缺少了package.json里的命令注册信息。
4.3 检查 settings.json 是否被同步污染
账户同步会把旧机器的settings.json带过来，里面可能包含已经失效的路径或插件专属配置。打开settings.json，搜索liveServer和open-in-browser，把不认识的、路径指向旧机器的配置项删掉。一个干净的配置片段长这样：
{ "liveServer.settings.port": 5501, "liveServer.settings.CustomBrowser": "chrome", "liveServer.settings.donotShowInfoMsg": true, "open-in-browser.default": "chrome" }如果你用的是 Cline 或 Claude Code 这类 AI 编码工具，它们的 MCP 配置里也可能引用了本地服务端口，端口冲突时同样会报错。这时候需要检查 MCP 的settings.json里有没有写死 5500。三件套要写全：Base URL、Key、Model ID，缺一个都会导致连接失败。比如：
{ "mcpServers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "你的Key", "model": "claude-sonnet-4-20250514" } } }注意 Base URL 不要带 UTM 参数，API 地址就是https://taotoken.net/api。如果你在配置里看到local proxy failed或者401，先检查 Key 是否过期，再检查 Base URL 是否写成了带路径的完整地址。
4.4 验证插件命令是否注册成功
按Ctrl+Shift+P打开命令面板，输入Live Server，看能不能搜到Live Server: Open with Live Server这个命令。如果搜不到，说明插件没加载成功，回到 4.2 重新删包安装。如果能搜到但点击没反应，那就是端口或浏览器的问题，回到第 2、3 节排查。
5. 常见报错对照排查：401、local proxy failed、reading choices
这一节把你在排查过程中可能遇到的真实报错列出来，对照着看能省不少时间。
command 'extension.liveServer.goOnline' not found：插件未加载或扩展包损坏。解法是删扩展包重装，参考 4.2。
401 Unauthorized：如果你在配置 AI 编码工具的 MCP 时遇到，说明 API Key 无效或过期。去控制台重新生成一个 Key，注意不要有多余空格。Base URL 用https://taotoken.net/api，不要加 UTM 参数。
local proxy failed：通常是本地端口被占用或代理配置冲突。检查 5500 端口是否被其他服务占用，参考第 2 节的netstat命令。如果你没有主动配置代理，检查系统环境变量里有没有HTTP_PROXY之类的设置。
Error reading choices：这个报错常见于 AI 编码工具调用模型接口时返回格式异常。先确认 Model ID 是否写对，比如claude-sonnet-4-20250514不要拼错。然后确认 Base URL 和 Key 是否匹配。如果用的是 Coding Plan 套餐，检查套餐是否还有额度。
OAuth相关报错：如果你在配置 Claude Code 或类似工具时看到 OAuth 失败，说明认证流程没走完。重新执行登录命令，或者改用 API Key 方式接入。API Key 方式更稳定，适合长期编码场景。
浏览器打开空白页：先手动访问http://127.0.0.1:5501，如果能打开说明服务正常，问题在浏览器关联；如果打不开，说明 Live Server 没起来，检查端口和插件状态。
打开的是file://路径而不是http://：说明你用的是 open in browser 而不是 Live Server。open in browser 不启动服务，直接打开本地文件，某些需要 HTTP 环境的页面会表现异常。需要 HTTP 服务就用 Live Server。
排查顺序建议：先看报错关键词，再按端口 → 浏览器 → 插件配置的顺序走。不要一上来就重装 VSCode，那是最没效率的做法。
6. 把配置固化下来，下次重装不再踩坑
排查完之后，建议你把可用的配置固化到settings.json里，并且用版本控制或者云同步保存一份。这样下次重装系统，直接粘贴配置，再装插件，基本不会再出问题。
一个经过验证的完整配置片段如下：
{ "liveServer.settings.port": 5501, "liveServer.settings.CustomBrowser": "chrome", "liveServer.settings.donotShowInfoMsg": true, "liveServer.settings.AdvanceCustomBrowserCmdLine": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe", "open-in-browser.default": "chrome", "open-in-browser.chromePath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe" }如果你需要调用模型能力来辅助编码，比如用 Claude Code 或者 Cline 做代码补全和重构，记得把 API Key 和 Base URL 配好。模型对话可以在 https://taotoken.net/api-keys 生成 Key，接入文档在 https://taotoken.net/doc 有详细说明。长期编码或 Agent 场景建议用 Coding Plan，地址是 https://taotoken.net/coding-plan。验证模型是否连通，可以直接在 https://taotoken.net/chat 里发一条消息测试。
最后一个小技巧：每次改完settings.json，按Ctrl+Shift+P执行Developer: Reload Window，让配置立即生效。不要靠重启 VSCode，那样太慢。端口检测命令和浏览器路径验证命令建议存成一个脚本，下次直接跑，省得重新查。
