VSCode调试Node.js时Ctrl+C不触发优雅停机，因调试器拦截SIGINT；应改用attach模式或integratedTerminal配合SIGTERM/SIGINT监听，并避免直接调用process.exit()。
VSCode调试Node.js时，process.exit() 会直接杀进程，导致数据库连接、文件写入、HTTP请求等未完成操作被强制中断——这不是“优雅停机”，只是粗暴终止。
为什么 Ctrl+C 在调试中不触发 graceful shutdown？
VSCode调试器接管了信号处理，SIGINT（Ctrl+C）默认被拦截并转为“终止调试会话”，不会透传给你的 Node.js 进程。所以你在断点里写的 process.on('SIGINT', ...) 根本收不到信号。
- 调试模式下，Node.js 进程实际运行在 VSCode 的调试代理之下，不是裸进程
-
process.exit()跳过所有清理逻辑，直接退出，beforeExit和exit事件也不触发 - 用
attach模式（如node --inspect启动后再连）时，SIGINT才可能正常送达，但前提是没被终端或 shell 层拦截
launch.json 里怎么配才能让 shutdown 可控？
关键不是加什么参数，而是避免让调试器替你“代劳”退出。推荐两种可落地的配置方式：
- 用
"request": "launch"+"console": "integratedTerminal"，并在代码里监听SIGTERM：VSCode 调试器不拦截SIGTERM，你可以在终端里手动发kill -TERM $PID触发清理 - 改用
"request": "attach"，启动时加--inspect并显式监听SIGINT：例如node --inspect=9229 --trace-warnings ./src/index.js，然后在launch.json中配"port": 9229；此时 Ctrl+C 会传给 Node 进程（只要没被 shell 层吞掉） - 不要依赖
process.exit()做主流程退出——它应只在超时兜底时调用，比如setTimeout(() => process.exit(1), 5000)
调试中如何模拟真实 shutdown 流程？
别等线上出问题才试。在本地调试阶段，就该用可复现的方式验证 shutdown 逻辑是否真正执行：
- 在代码开头加
process.on('SIGINT', () => { console.log('shutting down...'); cleanup(); });，确保cleanup()包含关闭 DB 连接、等待 pending HTTP 请求、server.close()等 - 调试时，在 Integrated Terminal 里运行
kill -INT $(pgrep -f 'node.*index.js')（Linux/macOS），或用 PowerShellGet-Process -Name node | Where-Object {$_.Path -like "*index.js*"} | Stop-Process -Force（Windows） - 观察日志是否输出 shutdown 步骤，而不是直接断连或报错
ECONNRESET - 如果用了
nodemon，注意它默认转发SIGUSR2，不是SIGINT，需额外配--signal SIGINT
真正容易被忽略的点是：调试器和进程信号之间的“透明度”根本不存在。你以为 Ctrl+C 是发给 Node 的，其实它先被 VSCode 拦下；你以为 process.exit() 是安全出口，但它根本不给你留关门时间。优雅停机不是加个监听函数就完事，而是得把信号路径、调试模式、进程生命周期三者对齐。
