VSCode指定--inspect后调试器无法启动，WSL环境却正常

针对你遇到的本地VSCode无法自动启动Node.js调试器（仅终端显示Debugger listening on ws://xxx地址），但WSL环境下同一配置正常的问题，可尝试以下步骤排查修复：

• 检查调试端口占用情况
  本地环境的9229端口可能被其他进程占用，导致VSCode无法连接调试器。执行对应命令排查：
  Windows系统：netstat -ano | findstr :9229
  找到占用端口的PID后，通过任务管理器结束对应进程，再重新运行node --inspect your-script.js。

• 重置调试相关配置

  1. 删除工作区根目录下的.vscode/launch.json文件（若存在），重新生成调试配置；
  2. 打开VSCode全局设置（快捷键Ctrl+,），确认"debug.javascript.autoAttachFilter"的配置值确实为"onlyWithFlag"，且未被工作区设置覆盖。

• 统一Node.js版本
  分别在本地和WSL环境下执行node -v，若两个环境的Node.js版本差异较大，可能存在调试协议兼容问题。建议使用nvm等版本管理工具，将本地Node.js版本调整为与WSL一致。

• 清理VSCode缓存
  关闭VSCode后，删除对应缓存目录的文件：
  Windows系统：%APPDATA%\Code\CachedData
  重启VSCode后重新尝试调试操作。

• 手动配置调试会话
  若自动附加仍失效，可手动创建attach模式配置：
  在.vscode/launch.json中添加如下内容：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "type": "node",
        "request": "attach",
        "name": "Attach to Node Debugger",
        "port": 9229,
        "skipFiles": ["<node_internals>/**"]
      }
    ]
  }
  

  运行node --inspect your-script.js后，点击VSCode调试面板的启动按钮，手动连接调试器。

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