PEST（PHP）中assert与expect的区别及适用场景

核心语法风格差异 #

• assert语法：继承自PHPUnit的传统断言风格，属于命令式写法，直接通过测试类的$this调用断言方法。
  示例：

  $user = User::factory()->create();
  $this->assertInstanceOf(User::class, $user);
  $this->assertEquals('active', $user->status);
  

• expect语法：PEST主推的BDD（行为驱动开发）风格语法，属于声明式写法，通过全局辅助函数expect()包裹目标对象后链式调用匹配器，更贴近自然语言描述。
  示例：

  $user = User::factory()->create();
  expect($user)->toBeInstanceOf(User::class)
               ->status->toBe('active');
  

功能细节差异 #

• 链式调用灵活性：expect支持流畅的链式属性访问与多断言组合，无需重复指定目标对象；assert则需要每次单独调用$this->assertXXX()，多断言场景下代码行数更多。
• 错误提示友好度：expect的失败提示更偏向自然语言，比如"Expected status to be 'active', got 'inactive'"；assert的提示是PHPUnit原生风格，技术化表述更强。
• 上下文依赖：assert必须依赖测试类的$this上下文（继承PHPUnit TestCase才能使用）；expect是全局可用函数，在PEST的无类测试闭包中也能直接使用，无需类上下文。

适用场景 #

• 优先选assert的场景：
  • 团队长期使用PHPUnit，希望保持测试代码风格统一；
  • 需要使用PHPUnit提供的部分边缘断言方法（部分特殊断言暂无expect匹配器对应实现）；
  • 编写单断言的简单测试，快速完成基础验证。
• 优先选expect的场景：
  • 追求测试代码的可读性，希望测试逻辑像自然语言描述一样清晰；
  • 对同一个对象/值进行多维度断言，链式写法更简洁；
  • 编写PEST的无类测试闭包，此时无$this上下文，只能使用expect。

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