离线安装Live Server插件必须手动补全其依赖的live-server二进制文件，否则“Go Live”按钮虽显示却无响应；需从GitHub下载对应平台的预编译live-server（非源码包），解压后放入插件目录的out/子目录，并赋予可执行权限，最后彻底退出并重启VSCode。
离线安装本地静态服务调试插件（如 ritwickdey.liveserver）的关键不是“装上就行”，而是必须补全它依赖的 Node.js 运行时资源——这个插件本身不带 HTTP 服务二进制，首次启用时会尝试下载并启动一个内嵌的 live-server 进程。离线环境下它直接静默失败，界面无提示，只表现为点击“Go Live”没反应、端口不监听、状态栏无图标。
为什么拖.vsix进去后“Go Live”按钮灰了
这不是插件没装成功，而是它卡在运行时依赖加载阶段：ritwickdey.liveserver 的 package.json 里声明了 "activationEvents": ["onCommand:extension.liveServer.start"]，但实际执行 start 命令时，会调用 child_process.spawn() 启动一个外部 live-server CLI。这个 CLI 不在 .vsix 包里，也不走 VSCode 扩展目录，而是由插件在首次运行时动态下载到 $HOME/.vscode/extensions/ritwickdey.liveserver-*/out/ 下并解压。
- 离线时该下载请求超时或被跳过，进程 spawn 失败，命令注册却已完成 → 按钮可点但无响应
- 查看 Developer Tools 控制台（
Ctrl+Shift+I），能看到类似spawn live-server ENOENT或Failed to download live-server binary的报错 - 插件显示“已启用”，只是前端壳子活了，后端服务根本没落地
手动补全 live-server 二进制文件
必须把 live-server 的预编译二进制（含 Node.js 兼容层）放进插件目录对应位置，否则永远无法启动。这不是可选步骤，是硬性前提。
- 去 GitHub Release 页面下载对应平台的
live-server：https://github.com/ritwickdey/live-server/releases，选live-server-vX.X.X-nodejs-*.zip（不是源码包） - 解压后得到一个
live-server（Linux/macOS）或live-server.exe（Windows）文件 - 找到你已安装的插件目录：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\ritwickdey.liveserver-*
macOS/Linux：$HOME/.vscode/extensions/ritwickdey.liveserver-* - 把
live-server或live-server.exe放进该目录下的out/子目录（若无则新建） - 确保文件有可执行权限（Linux/macOS）：
chmod +x out/live-server
code --install-extension 安装后必须彻底退出 VSCode
很多人装完插件就点“Go Live”，结果还是失败——因为 VSCode 缓存了扩展激活状态和模块解析路径，不杀干净进程不会重载 out/ 目录下的新二进制。
- 右下角系统托盘里的 VSCode 图标必须右键 → “Quit”，不能只关窗口
- 任务管理器里确认没有残留的
Code.exe或code helper进程（尤其是 Windows） - 重启后打开任意 HTML 文件，再点“Go Live”，此时应能正常监听
http://127.0.0.1:5500并自动刷新 - 验证是否真跑起来了：
netstat -ano | findstr :5500（Windows）或lsof -i :5500（macOS/Linux）
最容易被忽略的是：这个插件的离线可用性不取决于 .vsix 是否完整，而取决于你有没有把它真正依赖的那个独立二进制文件亲手塞进去。VSIX 只是“遥控器”，live-server 才是“发动机”。漏掉这一步，所有安装方式都只是在装一个不能点火的空壳。
