vscode 本身不配置虚拟机网络，需先在 vmware 中为 vmnet8 设置 nat 端口转发（如主机2222→虚拟机192.168.122.10:22），再在 vscode 中通过 remote-ssh 指定对应端口（ssh -p 2222 user@localhost）连接；服务须监听 0.0.0.0 而非 127.0.0.1，且 launch.json 的 pathmappings 必须严格匹配本地与远程绝对路径。
VSCode 本身不直接配置虚拟机网络，它只负责把本地端口通过 SSH 隧道转发到远程（比如 VMware 虚拟机）的指定端口；真正让宿主机能连上虚拟机的，是 VMware 的 NAT 端口转发设置。两者必须配合，缺一不可。
VMware NAT 网络必须先配好端口映射
这是整个链路的第一环，没配通，VSCode 后续所有操作都无效。
- 关掉所有运行中的虚拟机（VMware 要求配置生效前无活动 VM）
- 打开
编辑 → 虚拟网络编辑器，获取管理员权限 - 选中
VMnet8（NAT 模式），点NAT 设置 - 在端口转发规则里添加：主机端口（如
2222）→ 虚拟机 IP（如192.168.122.10）→ 目标端口22 - 保存后启动虚拟机，宿主机用
ssh -p 2222 user@localhost能连上，才算成功
VSCode Remote-SSH 连接时必须指定非标准 SSH 端口
因为 VMware 把宿主机的 2222 映射到了虚拟机的 22，VSCode 连接时不能默认走 22，否则会连错地方。
- 在 VSCode 命令面板（
Ctrl+Shift+P）输入Remote-SSH: Connect to Host... - 选择
Add New SSH Host...，输入完整连接串：ssh -p 2222 user@localhost - VSCode 会自动把这行写进
~/.ssh/config，生成类似：
Host vm-dev HostName localhost Port 2222 User user
之后所有操作都基于这个 vm-dev 主机名，而不是 localhost 或 IP。
转发调试端口前，先确认服务监听的是 0.0.0.0
VSCode 的 Forward a Port... 只能把请求发到虚拟机的 localhost:端口；如果服务只绑 127.0.0.1，隧道流量进不去——不是 VSCode 问题，是服务配置问题。
- Node.js：
node --inspect=0.0.0.0:9229 app.js（不是127.0.0.1:9229） - Python（debugpy）：
python -m debugpy --listen 0.0.0.0:5678 --wait-for-client script.py - 验证命令：
ss -tuln | grep :9229，输出中必须含*:9229或0.0.0.0:9229 - VSCode 中按
Ctrl+Shift+P→Remote-SSH: Forward a Port...→ 输入9229
launch.json 的 pathMappings 必须严格匹配绝对路径
断点失效最常见原因不是端口或连接，而是路径映射写错一个字符、多一个斜杠、用了相对路径。
- 本地项目路径是
/Users/alex/project，虚拟机里是/home/user/project -
launch.json中必须写成："pathMappings": {"/Users/alex/project": "/home/user/project"} - 不能写
"./project"、不能写"/Users/alex/project/"（末尾斜杠）、不能反着写 - 调试启动后，看 CALL STACK 里显示的文件路径是不是远程路径，不是就说明映射失败
虚拟机环境里没有“本地”概念，所有路径都是远程路径；VSCode 的调试器靠 pathMappings 把远程栈帧位置翻译回你编辑器里看到的文件，这一步容错率极低，写错就断点全失。
