结论：Hyper-V虚拟机默认不支持VSCode Node.js远程调试，因其未预装OpenSSH Server且“内部/专用”虚拟交换机阻断SSH及9229端口可达性；必须手动配置SSH、固定IP、防火墙放行及--inspect=0.0.0.0:9229，或改用Remote-WSL实现开箱即用调试。
直接说结论：Hyper-V 虚拟机里跑 Node.js，Windows 上 VSCode 无法用 Remote-SSH 直连调试——因为 Hyper-V 默认不装 OpenSSH Server，且网络模式（尤其是“专用”或“内部”交换机）会阻断 SSH 端口可达性。必须改用 Remote - WSL 或 Remote - SSH + 手动暴露端口 + 正确网络配置，否则断点不命中、attach 模式连不上、launch 报 Cannot launch program。
为什么 Hyper-V 虚拟机默认不支持 VSCode 的 Node.js 远程调试
VSCode 的 Node.js 调试依赖两个底层条件：一是目标环境能运行 node --inspect 并监听指定端口（如 9229）；二是 VSCode 主机端能 TCP 连通该端口。Hyper-V 默认创建的虚拟交换机（尤其是“内部网络”或“专用网络”）不转发主机到 VM 的入向连接，ssh 服务也未预装，导致 Remote - SSH 插件根本连不上。
- 查证方式：在 Hyper-V 中打开 VM 终端，执行
ss -tlnp | grep :22，若无输出，说明 SSH 未运行 - 查证网络：宿主机
telnet <VM_IP> 22或curl -v http://<VM_IP>:9229/json，超时即为网络不通 - 关键限制：Hyper-V 的“外部交换机”虽可桥接物理网卡，但 Windows 防火墙默认拦截入向连接，需手动放行
9229和22
用 attach 模式调试 Node.js 必须暴露并映射 9229 端口
launch 模式在 Hyper-V 场景下基本不可用（VSCode 无法在远程 VM 启动进程），只能靠 attach：先在 VM 里手动启动带 --inspect 的 Node 进程，再让 VSCode 主机连过去。但前提是端口可被宿主机访问。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- VM 内启动命令必须含
--inspect=0.0.0.0:9229（不能只写--inspect，后者默认绑定127.0.0.1） - Hyper-V 设置中，选中 VM → “设置” → “网络适配器” → “高级功能” → 勾选“启用固定 IP”，并在 VM 内用
ip addr确认 IP 固定（避免 DHCP 变更） - 宿主机防火墙需放行入向 TCP 端口
9229：netsh advfirewall firewall add rule name="Node Debug" dir=in action=allow protocol=TCP localport=9229 -
launch.json中address字段必须填 VM 的实际 IP（不是localhost），port填9229
launch.json 的 program 路径和工作区根目录容易错
即使网络通了，program 路径写错也会报 Cannot launch program because corresponding JavaScript file cannot be found。VSCode 不解析相对路径前缀 ./，也不认 __dirname。
- 正确写法：
"program": "${workspaceFolder}/src/server.js"（${workspaceFolder}是 VSCode 打开的远程文件夹路径，不是宿主机路径） - 错误写法：
"program": "src/server.js"（会被解释为 VSCode 安装目录下的路径） - 错误写法：
"program": "./src/server.js"（VSCode 完全忽略.前缀） - 验证方法：在 VSCode 内置终端里执行
pwd，输出即为${workspaceFolder}的实际值
比 Remote-SSH 更稳的替代方案是 Remote-WSL
如果 VM 用途只是跑 Node.js 开发环境，与其折腾 Hyper-V 网络，不如直接用 WSL2：它原生共享主机网络栈，localhost:9229 在 Windows 和 WSL2 里指向同一端口，attach 模式开箱即用，且无需配置 SSH、交换机、防火墙规则。
- 启用 WSL2：
wsl --install（Windows 11 22H2+ 自带） - 安装 Node.js 到 WSL2：
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs - VSCode 安装
Remote - WSL扩展，按Ctrl+Shift+P→Remote-WSL: New Window，直接打开 WSL2 文件系统 - 此时
launch.json中address可留空，port填9229即可，program路径照常写${workspaceFolder}
Hyper-V 的优势在于完整 Linux 发行版隔离，但对纯 Node.js 开发来说，WSL2 的桥接调试更轻量、更少出错点。真要用 Hyper-V，就得接受每次调试前手动确认 SSH 状态、端口映射、防火墙规则这三件事——漏一个，断点就灰掉。
