Jest是否保证单个测试文件内的测试串行执行？有无官方说明？

你的观察完全正确，目前Jest的并发执行机制确实是按测试文件级别并行，单个测试文件内部的测试用例（it/test）始终是串行执行的——也就是说，你提供的测试代码不需要添加--runInBand参数也能稳定通过，第二个测试一定会在第一个测试完成后运行，变量的累加逻辑能按预期生效。

这种做法是否安全？ #

从当前Jest的实现逻辑来看，是安全的。Jest的工作进程是按文件分配任务的，一个进程同一时间只会处理一个测试文件，文件内的所有测试会按编写顺序依次执行，不会出现单文件内测试并发的情况。

不过这里要提一个最佳实践建议：虽然当前这种依赖测试执行顺序的写法能跑通，但并不推荐。测试用例的核心原则是独立性——每个测试都应该能单独运行，不依赖其他测试的执行状态。比如你可以通过beforeEach在每个测试前重置变量，或者在每个it内部初始化变量，这样即使未来Jest的执行机制有调整（虽然可能性极低），你的测试依然能稳定工作，同时也能提升代码的可读性和可维护性。

优化后的示例代码：

describe('counting test', () => { 
  let variable;
  
  beforeEach(() => {
    variable = 0;
  });

  it('should start as 1', () => { 
    variable += 1; 
    expect(variable).toEqual(1); 
  }); 

  it('should change to 2', () => { 
    variable += 1; 
    expect(variable).toEqual(2); 
  }); 
});

官方文档的相关说明 #

你提到找不到明确的官方文档说明，这确实是因为Jest的文档没有把这一点单独拎出来强调，但在一些关于并发执行的章节里能找到隐含的线索：

• 在Jest配置项maxWorkers的说明中，提到Jest会使用多个工作进程来并行执行测试文件，这里的关键词是“文件”，而非“单个测试用例”；
• 在Jest的GitHub仓库讨论及核心开发人员的回复中，多次确认过：Jest的并行粒度是文件级，单文件内的测试始终串行执行，这是Jest设计时的既定行为。

总结一下：当前你的写法是安全的，但遵循测试独立性原则能让你的测试更健壮。

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