vitest单测试用例默认不进入worker线程,需手动创建worker并配置environment: 'node'、execargv调试参数及launch.json匹配端口;worker内存不完全隔离,需清理process.env和require.cache。

VSCode里Vitest单测试用例跑不进Worker线程?
不是Vitest没开多线程,而是默认根本不启用——vitest的--threads(或threads: true)只控制**测试文件级并行**,每个it()仍跑在主线程。单个测试用例想进独立Worker沙箱,必须显式用Worker构造函数或worker_threads模块自己创建,Vitest不自动包裹。
常见错误现象:写了new Worker('./heavy-task.js'),但断点不命中、process.env为空、报ReferenceError: Worker is not defined——本质是当前环境没暴露Worker全局对象。
- 确认
vitest.config.ts中environment: 'node'(不能是jsdom或happy-dom,那些环境没Worker) - 确保
vitest本地安装且版本≥2.0.0(旧版Worker支持不完整) - 若用ESM,
worker_threads需通过import { Worker } from 'worker_threads'导入,不能依赖全局
调试Vitest里的Worker线程为何断点全失效?
VSCode默认只附加主Vitest进程,Worker是独立Node子进程,不带--inspect参数就根本不会暴露调试端口——autoAttachChildProcesses: true对Vitest启动的Worker无效,因为Vitest不是直接fork(),而是通过spawn启动子进程且未透传调试参数。
必须手动给Worker传execArgv:
new Worker('./heavy-task.js', {
execArgv: ['--inspect-brk=9231']
});
同时确保launch.json配置匹配:
-
"autoAttachChildProcesses": true(开启子进程自动附加) -
"port": 9231(与execArgv中端口一致) -
"runtimeExecutable": "${env:NVM_BIN}/node"(避免Worker用错Node版本)
注意:端口号不能被占用;多个Worker必须用不同端口,否则VSCode只连第一个。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
Vitest单测试用例Worker内存隔离真的干净吗?
不干净。Worker进程虽独立,但和主测试进程共享同一Vitest实例的require.cache和process.env快照——比如你在主测试里process.env.DEBUG = 'true',Worker里console.log(process.env.DEBUG)会输出'true',这不是你想要的沙箱。
真正隔离要靠两层:
- Worker启动时清空环境:
execArgv加--no-warnings,并在Worker脚本开头执行delete process.env.DEBUG等手动清理 - 模块加载隔离:Worker内用
require('module').createRequire新建独立require上下文,避免复用主进程缓存
更彻底的做法是让Worker用spawn而非Worker构造函数,并传入{ env: { ...process.env, IS_WORKER: '1' } },再在Worker里完全重置process.env。
Vitest配置文件里哪些字段会破坏Worker沙箱?
setupFiles和globalSetup是隐形杀手——它们在Worker进程启动前就被执行,且代码会污染Worker的全局作用域。比如setupFiles: ['./test-setup.ts']里写了global.MyLib = {},所有Worker都会继承这个global属性。
安全做法:
- Worker脚本里不依赖任何
setupFiles注入的全局变量,全部显式import - 把Worker逻辑写成纯函数,输入参数全靠
postMessage传递,避免读取global或process - 禁用
globalSetup,改用Worker内部的beforeAll做初始化
最容易被忽略的是testEnvironmentOptions——它会被透传到Worker,但Worker不解析这个字段,反而可能触发未知副作用。










