VSCode 不压缩 JS 文件，卡顿源于 Node 脚本同步 I/O；应改用 Promise.all 并发读取、排除 node_modules 监听、正确配置 launch.json 的 program 和 args，并设置 skipFiles 与 env 优化调试。
直接说结论：VSCode 本身不参与 JS 文件的压缩合并过程，所谓“I/O 调试”本质是调试你写的 Node.js 脚本（比如用 fs.readFileSync 批量读取、fs.writeFileSync 写入合并结果），不是 VSCode 在“压缩文件”。卡顿、超时、内存溢出，90% 出在脚本逻辑或 I/O 配置上，而非编辑器设置。
为什么大量小文件合并时 VSCode 会假性卡死
这不是调试器的问题，而是你运行的 Node 脚本在同步阻塞式读写——尤其当用 fs.readFileSync 循环读取几百个 .js 文件时，主线程被占满，VSCode 的内置终端响应延迟，甚至调试器暂停也变慢。更隐蔽的是：VSCode 默认监听整个工作区，node_modules 和输出目录（如 dist/）若没排除，文件变更事件风暴会拖垮文件监视器。
- 现象：按 F5 启动后几秒无响应，终端光标不动，变量面板空白
- 真实原因：你的合并脚本正在同步读取 327 个文件，单次
fs.readFileSync平均耗时 8ms，仅读取就卡住主线程 2.6 秒 - 验证方式：在脚本开头加
console.time('read')，结尾加console.timeEnd('read')，看终端实际耗时 - 解决方向：改用
fs.promises.readFile+Promise.all并发读取；或用stream.pipeline流式拼接，避免全量内存加载
launch.json 中 program 指向合并脚本的硬性要求
program 字段必须指向一个真实存在的、可直接 node 执行的 .js 文件，且不能是 TypeScript 源码或 ESM 模块（除非 package.json 明确声明 "type": "module"）。路径错误会导致断点灰掉、提示 Cannot launch program，但错误信息常被淹没在终端日志里。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 正确写法：
"program": "${workspaceFolder}/scripts/merge.js"（推荐，跨平台安全） - 绝对禁止：
"program": "scripts/merge.js"（VSCode 不补前缀，等同于找当前工作目录下的 scripts/merge.js，而调试时工作目录是项目根） - ESM 项目要加
"runtimeArgs": ["--experimental-specifier-resolution=node"]，否则import语句直接报错退出，断点根本不会命中 - 如果合并脚本依赖
process.argv接收参数（如输入目录），在args字段里显式传入："args": ["./src/js/lib/"]
调试 I/O 瓶颈时 skipFiles 和 env 的关键作用
默认调试配置下，Node.js 会把 fs、path、events 等核心模块的内部调用也纳入堆栈，一旦你在 fs.readFileSync 上设了断点，调试器会频繁跳进 V8 底层，完全掩盖你脚本本身的逻辑流。同时，未设环境变量可能导致脚本读错路径或跳过压缩步骤，让你误以为“断点没生效”。
-
skipFiles必须包含："<node_internals>/**"</node_internals>（跳过 Node 内部）和"node_modules/**/*.js"（跳过所有依赖，防止误入 terser 或 glob） -
env建议加上："NODE_ENV": "development"（避免生产级压缩逻辑干扰调试）、"DEBUG_IO": "true"（供脚本内条件打印 I/O 路径） - 慎用
autoAttachChildProcesses：合并脚本若 spawn 了terser子进程，开启此选项会让调试器试图附加到子进程，导致主进程调试中断或崩溃 - 观察 “调试控制台” 而非终端：执行
profile命令抓 CPU 时间线，能清晰看到fs.readSync是否长期占据主线程
最易被忽略的一点：合并脚本里的 process.cwd() 行为受启动方式影响极大。用 request: "launch" 时它是项目根目录；但若你改成 request: "attach" 并手动在终端跑 node --inspect scripts/merge.js，它的值取决于你当时在哪个目录下执行的命令——同一行 fs.readdirSync('./src') 可能成功也可能抛 ENOENT，而 VSCode 不会提醒你 cwd 变了。
