FluentAssertions 通过强类型断言和业务意图表达升级测试质量，需按值类型选用对应方法：字符串区分大小写、浮点数默认容差、对象用 BeEquivalentTo、异步/函数式类型有专用链式验证，多断言用 AssertionScope 汇总失败。
直接上结论：FluentAssertions 不是让你“换种写法”，而是帮你把断言从“检查是否相等”升级为“声明业务意图并精准定位失败点”。装完包、加 using FluentAssertions; 就能用，但多数人卡在类型误用、空值崩溃和字符串默认行为上。
为什么 .Should().Be() 一用就报错或静默失败
常见错误现象包括：.Should() 红波浪线（没加 using）、.Be(5) 对字符串编译失败、"5".Should().Be(5) 直接不通过（类型不匹配）、Assert.That 写法报 CS0103。
-
.Should()是扩展方法，必须作用在**已有值**上，不能写Assert.That(x).Should()或FluentActions.Should() -
.Be()是强类型比较：整数比整数、字符串比字符串，"5".Should().Be(5)编译不过，5.Should().Be("5")同样不行 - 字符串默认区分大小写和首尾空格，
"ABC".Should().Be("abc")必然失败；要忽略大小写，得显式用.Be("abc".ToLowerInvariant())或.MatchRegex("^abc$", RegexOptions.IgnoreCase) - 浮点数比较默认容差 1e-10，不用传 delta；如需放宽，用
.BeApproximately(3.14, 0.001)
.Should().BeEquivalentTo() 才是对象/集合比较的主力
手写 foreach 比对、用 SequenceEqual、甚至 Assert.Equal(list1, list2) 都容易踩坑——xUnit 的 Assert.Equal 对 List<T> 默认比引用，不是内容。
-
obj1.Should().BeEquivalentTo(obj2)自动递归比所有公共属性，不依赖Equals实现，也不要求实现IEquatable<T> - 忽略字段：
.BeEquivalentTo(expected, opt => opt.Excluding(x => x.Id)) - 允许顺序不同：
.BeEquivalentTo(expected, opt => opt.WithStrictOrdering = false) - 集合为空但非 null？
list.Should().HaveCount(0)安全；若可能为null，先写list.Should().BeNull()或list.Should().NotBeNull().And.HaveCount(3)
异步、异常、Maybe/Result 类型怎么断言
原生 Assert.ThrowsException<T>(() => ...) 只捕获抛出动作，没法链式验证消息或内部状态；Maybe<T> 这类函数式类型更不能用 .Be() 直接比。
- 异步方法不抛异常：
await service.DoAsync().Should().NotThrowAsync() - 捕获并验证异常：
await Awaiting(() => service.ProcessAsync()).Should().Throw<InvalidOperationException>().WithMessage("timeout*") -
Maybe<string> m = Maybe<string>.From("ok"); m.HasValue.Should().BeTrue(); m.Value.Should().Be("ok")—— 先断状态，再断值 - 对
Result<T, E>，推荐先.IsSuccess.Should().BeTrue()，再链式查.Value或.Error
多个断言失败时只报一个？用 AssertionScope
写三行 .Should()，第一行失败，后两行根本不会执行，你永远不知道其他字段是否也错了。
- 包一层
using new AssertionScope()，所有断言一起跑，失败时汇总输出全部差异 - 适合验证对象多个属性、DTO 映射结果、计算类多个输出字段
- 注意别滥用：嵌套超过 3 层（比如
.And.HaveProperty().Which.Name.Should()）建议拆开，否则失败堆栈难读
最常被忽略的一点：FluentAssertions 的行为高度依赖你传入的**实际值类型**。string、IEnumerable<T>、Maybe<T>、Task<T> 各有专用入口和约束逻辑，别想当然复用 .Be() —— 看文档前先确认变量运行时类型。
