如何在本地VSCode访问虚拟机中NodeJS项目并运行调试？

一、解决SMB共享下npm start失败的问题 #

核心原因 #

本地VSCode终端默认调用本地Node/npm环境，但你的项目依赖仅安装在虚拟机中，本地环境缺少对应依赖或版本不匹配，导致命令执行失败。

推荐解决方案：使用VSCode Remote - SSH（替代SMB共享） #

这是最稳定的远程开发方式，终端直接运行在虚拟机环境中：

1. 在VSCode扩展商店安装Remote - SSH插件
2. 按F1调出命令面板，输入Remote-SSH: Connect to Host，选择Add New SSH Host
3. 输入虚拟机的SSH连接命令（Windows虚拟机需先开启SSH服务）：ssh 虚拟机用户名@machine_ip，保存到配置文件
4. 连接成功后，打开虚拟机内的项目路径（对应C:\project_folder的路径通常为/c/project_folder，可根据虚拟机系统调整）
5. 此时终端为虚拟机的Shell环境，直接执行npm start即可调用虚拟机的Node和依赖启动项目

备选方案：保持SMB共享，远程执行命令 #

如果坚持使用SMB挂载文件夹，需通过SSH远程调用虚拟机的命令：

• 在VSCode终端执行：

  ssh 虚拟机用户名@machine_ip "cd C:\project_folder && npm start"
  

• 可配置VSCode任务简化操作：按Ctrl+Shift+B，选择Create tasks.json from template，添加如下任务：

  {
      "version": "2.0.0",
      "tasks": [
          {
              "label": "Start Remote App",
              "type": "shell",
              "command": "ssh 虚拟机用户名@machine_ip \"cd C:\\project_folder && npm start\"",
              "problemMatcher": []
          }
      ]
  }
  

之后按Ctrl+Shift+B选择Start Remote App即可一键启动。

二、VSCode中执行NodeJS程序的方法 #

1. 直接执行单个文件 #

• 打开目标.js文件，右键选择Run Node.js File in Terminal
• 或在内置终端手动输入：node 文件名.js

2. 通过package.json脚本执行 #

若项目有package.json（包含启动脚本）：

• 终端执行npm start（对应scripts中的"start"字段）
• 其他脚本用npm run 脚本名，比如npm run dev（需在package.json中定义："dev": "node --watch app.js"）

3. 调试模式执行 #

• 按F5，VSCode会自动生成launch.json配置文件（首次调试时）
• 默认配置即可启动断点调试，如需自定义，可修改launch.json，示例：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "type": "node",
              "request": "launch",
              "name": "Launch App",
              "program": "${workspaceFolder}/app.js",
              "env": { "NODE_ENV": "development" }
          }
      ]
  }
  

• 设置断点后按F5即可逐行调试

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