在C#中快速运行xUnit测试需安装xunit和xunit.runner.visualstudio包，测试类和方法须满足public、无参构造、无返回值及相应特性；Mock HttpClient应避免直接Mock，改用接口或HttpMessageHandler模拟。
怎么在C#项目里快速跑起xUnit测试
必须先确认：xUnit本身不带运行器，.NET SDK 6+ 项目默认支持 dotnet test，但得装对包。常见失败不是代码写错，而是漏了依赖。
- 确保项目文件（
.csproj）里有<packagereference include="xunit" version="2.8.1"></packagereference>和<packagereference include="xunit.runner.visualstudio" version="2.8.1"></packagereference>（后者是让VS能识别测试的关键） - 测试类必须是
public，且不能有构造函数参数（除非用[Collection]管理共享状态） - 测试方法必须是
public、无返回值（void或Task）、带[Fact]或[Theory]特性；命名无所谓，但别用中文或空格 - 执行命令直接用
dotnet test，不用额外启动服务——如果提示“no test is available”，八成是没装xunit.runner.visualstudio或目标框架不匹配（比如测试项目用了net6.0，但被测项目是net472）
Mock HttpClient 时为什么总是抛出“Operation is not supported on this platform”
这是 .NET Core/.NET 5+ 下最典型的 Mock 失败场景：直接对 HttpClient 实例调用 new Mock<httpclient>()</httpclient> 会报错，因为 HttpClient 类型被设计为不可继承（sealed），Moq 无法生成代理。
- 正确做法是面向接口编程：把 HTTP 调用封装进一个接口（如
IHttpService），再让实现类内部使用HttpClient - 或者改用
HttpMessageHandler模拟——创建Mock<httpmessagehandler></httpmessagehandler>，重写SendAsync方法，再传给HttpClient构造函数：new HttpClient(mockHandler.Object) - 注意：
HttpClient实例本身不该被 Mock，它是协调者；真正要隔离的是网络行为，不是它本身 - 如果你用的是
Refit或Flurl，优先 Mock 它们的接口（如IGitHubApi），而不是碰HttpClient
Moq 的 Setup 和 SetupSequence 到底该用哪个
Setup 是基础，但很多真实场景需要多次调用返回不同值（比如分页请求、重试逻辑），这时候硬写多个 Setup 会覆盖，必须用 SetupSequence。
-
Setup(x => x.GetById(1)).Returns("A")：只要参数是1，永远返回"A" -
SetupSequence(x => x.NextId()).Returns(100).Returns(101).Returns(102)：第一次调用返回100，第二次101，第三次起都返回102 - 如果被测逻辑里有多线程调用同一个 Mock 方法，
SetupSequence不保证线程安全，此时应改用Callback+ 外部计数器（如int counter = 0; Setup(x => x.Get()).Callback(() => counter++).Returns(() => values[counter])） - 别对
void方法用Returns，要用Callback捕获调用参数做验证
Assert.Throws 和 Assert.ThrowsAsync 的坑在哪
很多人写 Assert.Throws<argumentnullexception>(() => service.Do(null))</argumentnullexception> 后发现测试通过，但其实异常根本没被抛出——是因为委托体里发生了其他异常（比如 NRE），而 Assert.Throws 只认指定类型，其余一概当失败。
- 务必确认你捕获的异常类型和实际抛出的一致：
ArgumentException≠ArgumentNullException，基类异常不会匹配子类断言 - 异步方法必须用
Assert.ThrowsAsync，写成Assert.Throws<t>(async () => await ...)</t>会导致编译失败（委托类型不匹配） - 如果想检查异常消息，不要链式调用
.Message.Contains(...)，而应该先接收异常对象：var ex = Assert.Throws<invalidoperationexception>(() => ...); Assert.Equal("expected", ex.Message);</invalidoperationexception> - 在 xUnit 中，
Assert.Throws内部会吞掉异常堆栈；如需调试，临时改成直接调用并用 try/catch 打印ex.ToString()
Mock 的边界很清晰：只模拟你明确控制的部分，比如依赖服务、数据访问层；别试图 Mock DateTime.Now 或 Configuration —— 那该用包装接口或测试配置替代。越靠近基础设施，越容易因平台差异翻车。
