VS Code调试Node.js应用时自动生成的Run-Script配置运行原理及复现方法

VS Code自动生成Run-Script配置的逻辑 #

VS Code内置的前端/Node.js调试组件会自动扫描当前项目根目录下package.json的scripts字段，识别所有可执行的包管理脚本，在运行调试面板生成对应的临时配置。这类配置存储在本地编辑器缓存中，不属于项目共享配置，因此无法直接提交到代码仓库。

复现自动配置逻辑并共享的操作步骤 #

1. 首先查看自动生成配置的完整参数：打开运行和调试面板，点击自动生成的start:debug配置右侧的齿轮图标，即可调出完整的配置JSON内容
2. 将调出的配置内容复制到项目根目录的.vscode/launch.json文件中（如果文件不存在可以手动创建）
3. 检查核心配置项是否匹配自动生成的规则，避免出现输出不全的问题：
   • 确保console字段值为integratedTerminal，不要使用internalConsole，后者仅会输出调试器日志，不会捕获应用的标准输出、报错信息
   • Node.js项目可添加"outputCapture": "std"配置，全量捕获应用运行时的所有控制台输出
   • 确认runtimeExecutable字段和团队统一使用的包管理器匹配，比如用pnpm就填pnpm，用yarn就填yarn
   • cwd字段设置为${workspaceFolder}，保证调试时工作目录统一为项目根目录
4. 配置.gitignore规则，仅提交共享的调试配置，忽略其他本地VS Code设置：

.vscode/*
!.vscode/launch.json

将修改后的.vscode/launch.json和.gitignore提交到代码仓库后，所有团队成员拉取代码后打开VS Code即可直接使用这套稳定的调试配置。

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