node进程卡死但ctrl+c无反应，不等于死锁，更可能是阻塞在系统调用或native模块；真正死锁表现为请求挂起、cpu先飙高后归零、新请求全无响应，且日志反复出现session_id not found或output lock提示。
Node进程卡死但Ctrl+C无反应，先确认是不是真死锁
VSCode里按Ctrl+C没反应，不等于就是死锁——更可能是进程阻塞在系统调用（如fs.readFileSync、child_process.spawnSync）或native模块里。真正的死锁表现为：请求挂起、CPU先飙高再归零、后续所有新请求无响应，且日志里反复出现session_id not found或output lock相关提示。
验证方法：另开终端执行codexsession list，若返回多个状态为Alive但实际已超时的会话ID，基本可判定是异步任务互锁型死锁；如果是CommonJS循环引用导致的“半初始化”，则表现为TypeError: xxx is not a function或属性为undefined，且require()调用链里能观察到重复加载同一模块。
用require.cache和日志快速定位CommonJS循环引用
Node.js不会报“循环引用警告”，而是静默返回未初始化完的module.exports。排查时不靠IDE跳转，而要靠运行时痕迹：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在每个疑似模块顶部加
console.log('loading', module.id)，运行后看输出是否出现闭环，例如loading ./a.js → loading ./b.js → loading ./a.js - 更准的做法是在每模块开头插入
console.log(module.id, 'exports:', Object.keys(module.exports))，对比哪个模块被require时exports还是空对象 - VSCode中按
Ctrl+Shift+P→Developer: Toggle Developer Tools，在Console里输入Object.keys(require.cache)，手动检查路径是否包含重复或异常顺序
调试器连不上？先确保launch.json没踩这三个坑
死锁问题常需F5调试介入，但断点不触发、Cannot find program等错误会让排查直接卡住：
-
program字段必须是相对于工作区根目录的绝对路径变量，写成"program": "src/index.js"或"./src/index.js"都会失败，正确写法是"program": "${workspaceFolder}/src/index.js" - TypeScript项目别直接指向
.ts文件——除非配了preLaunchTask编译，否则调试器找不到对应.js，报Cannot launch program because corresponding JavaScript cannot be found - Express/Koa类服务推荐用
attach模式而非launch，避免因环境变量、端口占用或子进程fork导致启动失败，launch模式下EADDRINUSE错误很常见
VSCode集成终端里杀不死进程？别用taskkill /im node.exe
Ctrl+C失效后，直接关终端标签页容易残留node.exe僵尸进程，后续导致Address already in use或拖慢编辑器：
- 先尝试
Ctrl+Shift+P→ 输入并执行Terminal: Kill the Active Terminal Instance，这是VSCode官方推荐的温和终止方式 - 若无效，新开终端精准匹配：macOS/Linux用
pgrep -f "npm run dev"查PID，再pkill -f "npm run dev"；Windows用tasklist /FI "IMAGENAME eq node.exe" /FO LIST | findstr "npm run dev"确认命令行完整匹配后再taskkill /F /PID <pid></pid> - 绝对避免
taskkill /F /IM node.exe——它会干掉所有Node进程，包括你正在调试的其他项目
CommonJS循环引用和异步互锁死锁的表象相似，但根因和修复路径完全不同：前者发生在模块加载期，靠延迟加载或提取共享状态解决；后者发生在运行时资源争用，得靠调整并发策略或锁持有逻辑。别只盯着报错行，得顺着require()或await调用栈往回翻，找到最早那个“不该在此时出现”的依赖或等待点。
