VSCode调试Node.js时canvas模块版本不兼容问题求助

我编写了test.js文件，代码如下：

const { createCanvas, loadImage } = require('canvas');

console.log('hi');

在VSCode的launch.json中配置了如下调试项：

...
    {
      "name": "test script",
      "type": "node",
      "request": "launch",
      "runtimeExecutable": "node",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/test.js",
      "console": "integratedTerminal"
    },
...

在VSCode调试器中运行该调试项时，出现NODE_MODULE_VERSION不兼容错误（版本93与83不匹配）。但直接在终端执行node test.js，或者将launch.json中的runtimeExecutable改为nodemon后调试，脚本都能正常运行。尝试删除node_modules并执行npm rebuild或npm install，问题仍未解决，恳请协助排查。

1. 核对VSCode调试与终端使用的Node版本 #

VSCode调试器可能调用了和终端不同的Node版本：

• 在VSCode内置终端执行node -v，记下版本（对应关系：v16.x对应NODE_MODULE_VERSION 93，v14.x对应83）
• 在系统原生终端执行node -v，对比两个版本是否一致
• 若不一致，在launch.json的调试配置中指定终端使用的Node完整路径：

  "runtimeExecutable": "/usr/local/bin/node" // macOS/Linux示例
  // Windows示例："C:\\Program Files\\nodejs\\node.exe"
  

2. 修复版本管理器（如nvm）的环境继承问题 #

如果用nvm管理Node版本：

• 必须从已激活目标Node版本的终端启动VSCode，否则VSCode无法继承nvm的环境变量
• 或者在launch.json中添加env配置，手动指定nvm的Node路径：

  "env": {
    "PATH": "/Users/你的用户名/.nvm/versions/node/v16.18.0/bin:${env:PATH}"
  }
  

3. 强制重新编译canvas原生模块 #

canvas是依赖Node版本的原生模块，可能编译时绑定了错误版本：

• 手动删除node_modules/canvas/build目录
• 执行npm rebuild canvas --update-binary，强制重新编译并匹配当前Node版本

4. 更新VSCode的Node调试插件 #

旧版本的Node调试插件可能存在兼容问题：

• 打开VSCode扩展面板，搜索"Node.js Debug"，检查并更新到最新版本
• 更新完成后重启VSCode再尝试调试

内容的提问来源于stack exchange，提问作者Dashiell Rose Bark-Huss