Sinon Stub替换类静态方法时全局生效，无法仅限定单个describe块的问题求助

这个问题我之前也碰到过，核心原因是测试框架（比如Mocha）的执行顺序和你对stub生命周期的控制没匹配上。让我先拆解一下为什么会出现全局替换的情况：

为什么你的代码会出问题？ #

Mocha的执行流程是这样的：

1. 先遍历所有describe块，执行里面的同步代码（比如你在Test Dog的describe顶层直接创建stub的代码）
2. 然后才按顺序运行所有it测试用例
3. 最后执行afterAll/afterEach这类钩子

你在Test Dog的describe顶层直接创建了stub，这意味着在所有测试用例（包括Test Cat里的Meows）执行之前，Cat.sound就已经被替换成返回"Woof"了。而afterAll是在Test Dog的所有测试跑完之后才恢复原方法，这时候Test Cat的测试早就执行完了，自然会拿到错误的返回值。

哪怕用了createSandbox，只要你还是在describe顶层同步创建stub，问题就不会解决——因为sandbox本身只是帮你批量管理stub，并没有改变执行时机的问题。

正确的解决方案 #

要实现仅在目标describe块内替换静态方法，关键是把stub的创建和恢复放到正确的钩子函数里，确保stub只在需要的测试周期内生效。

方案1：用beforeEach和afterEach控制stub生命周期 #

把stub的创建放到beforeEach（每个测试前执行），恢复放到afterEach（每个测试后执行），这样能保证stub只在当前describe的测试用例中生效，测试结束后立刻恢复原方法：

const sinon = require("sinon");
const { Cat } = require("./myClass");

describe("Main tests", () => {
  describe("Test Cat", () => {
    it("Meows", () => {
      expect(Cat.sound()).toBe("Meow")
    })
  })

  describe("Test Dog", () => {
    let stub;

    beforeEach(() => {
      // 每个测试用例执行前创建stub
      stub = sinon.stub(Cat, "sound").callsFake(() => "Woof");
    });

    afterEach(() => {
      // 每个测试用例执行后恢复原方法
      stub.restore();
    });

    it("Barks", () => {
      expect(Cat.sound()).toBe("Woof")
    })
  })
})

方案2：用Sinon Sandbox批量管理（更简洁） #

如果你的测试里有多个stub，用Sandbox会更方便——它可以一次性恢复所有创建的stub，不用单独管理每个stub的restore：

const sinon = require("sinon");
const { Cat } = require("./myClass");

describe("Main tests", () => {
  describe("Test Cat", () => {
    it("Meows", () => {
      expect(Cat.sound()).toBe("Meow")
    })
  })

  describe("Test Dog", () => {
    const sandbox = sinon.createSandbox();

    beforeEach(() => {
      // 用sandbox创建stub
      sandbox.stub(Cat, "sound").callsFake(() => "Woof");
    });

    afterEach(() => {
      // 一次性恢复所有sandbox创建的stub
      sandbox.restore();
    });

    it("Barks", () => {
      expect(Cat.sound()).toBe("Woof")
    })
  })
})

方案3：在单个测试用例内创建并恢复（适合单一测试场景） #

如果只有一个测试用例需要替换方法，也可以直接在it里面创建stub，并用try/finally确保即使测试失败也能恢复原方法：

const sinon = require("sinon");
const { Cat } = require("./myClass");

describe("Main tests", () => {
  describe("Test Cat", () => {
    it("Meows", () => {
      expect(Cat.sound()).toBe("Meow")
    })
  })

  describe("Test Dog", () => {
    it("Barks", () => {
      const stub = sinon.stub(Cat, "sound").callsFake(() => "Woof");
      try {
        expect(Cat.sound()).toBe("Woof")
      } finally {
        // 不管测试成功失败，都恢复原方法
        stub.restore();
      }
    })
  })
})

关键总结 #

• 绝对不要在describe块的顶层同步创建stub，这会导致stub在所有测试前就生效
• 用beforeEach/afterEach来控制stub的生命周期，确保它只在目标测试用例的执行周期内存在
• Sandbox是管理多个stub的好工具，但也要配合正确的钩子函数使用

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