VSCode调试器执行node脚本别名时无法触发断点如何解决

核心原因 #

你在普通终端执行别名启动的Node进程未开启调试端口，VSCode默认的launch配置是独立启动新的Node进程，和你终端运行的进程无关，因此无法触发断点。

解决方案 #

方案1：使用VSCode自动附加终端（无需修改配置，最便捷）

1. 按Ctrl+Shift+P（Mac按Cmd+Shift+P）打开命令面板，执行Debug: Toggle Auto Attach，选择Always模式
2. 关闭当前VSCode集成终端，新开一个集成终端
3. 直接在这个新终端内执行alias1 arg1，VSCode会自动识别Node进程并附加调试器，预设断点即可正常触发

方案2：手动附加到别名启动的进程

1. 修改~/.zshrc中的别名，给node命令添加--inspect参数开启调试端口：

alias alias1="node --inspect /path/to/examples/js/cli alias1 arg2"
alias alias2="node --inspect /path/to/examples/js/cli alias2 arg2"

修改完成后执行source ~/.zshrc生效。如果需要进程启动后暂停在第一行等待调试器连接，可以把--inspect换成--inspect-brk。

2. 修改launch.json添加附加调试配置：

{
    "version": "0.2.0",
    "configurations": [
        {
          "type": "pwa-node",
          "request": "launch",
          "name": "Launch Program",
          "program": "${workspaceRoot}/examples/js/cli.js"
        },
        // 新增以下配置
        {
          "type": "pwa-node",
          "request": "attach",
          "name": "Attach to Running Node",
          "port": 9229
        }
    ]
}

3. 操作流程：终端执行alias1 arg1，看到输出Debugger listening on ws://127.0.0.1:9229/xxx后，在VSCode调试面板选择Attach to Running Node配置启动，即可触发断点。

方案3：直接在VSCode调试启动配置中模拟别名参数

如果不需要在终端手动敲别名，可以直接把别名的参数写到launch配置里，直接从VSCode启动调试：

{
    "version": "0.2.0",
    "configurations": [
        {
          "type": "pwa-node",
          "request": "launch",
          "name": "Launch alias1",
          "program": "${workspaceRoot}/examples/js/cli.js",
          "args": ["alias1", "arg2"]
        },
        {
          "type": "pwa-node",
          "request": "launch",
          "name": "Launch alias2",
          "program": "${workspaceRoot}/examples/js/cli.js",
          "args": ["alias2", "arg2"]
        }
    ]
}

需要调试哪个别名，直接在调试面板选择对应的配置启动即可，自动传入参数，断点直接生效。如果需要额外传入动态参数，可以在args中添加${input:自定义参数名}，配合inputs配置实现启动时输入参数。

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