如何扩展NUnit框架实现自定义传参与外部触发测试运行？

作为经常用NUnit做测试的开发者，刚好能解决你这两个需求——给测试类传外部对象，以及从自己的应用（控制台/WinForms）触发测试。下面分两部分一步步讲：

一、给测试类传递外部对象 #

NUnit默认会自己实例化测试类，所以直接用构造函数传参得用点小技巧，这里有两种实用方案：

方案1：用TestContext.Properties传递（无需额外依赖，快速上手） #

这个方式最直接，不用装额外包：

1. 测试类中读取对象
   在测试类的[SetUp]初始化方法或者测试方法里，从TestContext里取出预先传入的对象：

   using NUnit.Framework;
   
   [TestFixture]
   public class MyTests
   {
       private MyExternalObject _externalObj;
   
       [SetUp]
       public void Setup()
       {
           // 从TestContext的测试包设置里取对象
           _externalObj = TestContext.CurrentContext.TestPackage.Settings["MyExternalObj"] as MyExternalObject;
       }
   
       [Test]
       public void TestUsingExternalData()
       {
           Assert.IsNotNull(_externalObj, "外部对象未传入");
           // 这里就可以用_externalObj写测试逻辑了
       }
   }
   

2. 触发测试时注入对象
   后面讲自定义入口的时候，会用NUnit引擎API把对象塞进测试包的设置里，测试类就能拿到了。

方案2：用NUnit依赖注入（更优雅，适合复杂场景） #

如果你的测试需要多个依赖，或者想保持代码整洁，推荐用NUnit.DependencyInjection库实现构造函数注入：

1. 安装NuGet包
   在测试项目里安装NUnit.DependencyInjection包。

2. 配置DI容器
   新建一个启动类，实现INUnitTestStartup接口，注册你的外部对象。这里我们可以用一个静态类临时持有从外部应用传入的对象：

   using NUnit.Framework;
   using NUnit.DependencyInjection;
   using Microsoft.Extensions.DependencyInjection;
   
   // 静态类用来临时存外部传入的对象
   public static class ExternalObjectHolder
   {
       public static MyExternalObject MyObj { get; set; }
   }
   
   public class TestStartup : INUnitTestStartup
   {
       public void ConfigureServices(IServiceCollection services)
       {
           // 注册外部对象为单例
           services.AddSingleton(ExternalObjectHolder.MyObj);
       }
   }
   

3. 测试类构造函数注入
   现在测试类可以直接通过构造函数拿到对象，不用再手动从TestContext里取：

   [TestFixture]
   public class MyTests
   {
       private readonly MyExternalObject _externalObj;
   
       // 构造函数自动注入
       public MyTests(MyExternalObject externalObj)
       {
           _externalObj = externalObj;
       }
   
       [Test]
       public void TestWithInjectedObject()
       {
           Assert.IsNotNull(_externalObj);
           // 用注入的对象执行测试
       }
   }
   

二、从自定义应用（控制台/WinForms）触发NUnit测试运行 #

要在自己的应用里跑NUnit测试，得用NUnit的NUnitEngine API——它允许你编程式地发现和运行测试，完全脱离NUnit的GUI或命令行工具。

步骤1：安装NUnitEngine相关包 #

在你的应用项目（控制台/WinForms）里装这两个NuGet包：

• NUnitEngine
• NUnitEngine.Api

步骤2：编写测试运行逻辑 #

下面以控制台应用为例，WinForms的话直接把逻辑放到按钮点击事件里就行：

using NUnit.Engine;
using System;

class Program
{
    static void Main(string[] args)
    {
        // 1. 创建你要传给测试类的外部对象
        var myExternalObj = new MyExternalObject
        {
            SomeProperty = "来自控制台应用的测试数据"
        };

        // 如果用的是DI方案，把对象放到静态持有者里
        ExternalObjectHolder.MyObj = myExternalObj;

        // 2. 初始化NUnit引擎
        using var engine = TestEngineActivator.CreateInstance();
        // 替换成你的测试项目DLL路径，比如@"..\..\..\MyTestProject\bin\Debug\net6.0\MyTestProject.dll"
        var testPackage = new TestPackage(@"Path\To\Your\TestProject.dll");

        // 如果用的是TestContext方案，把对象塞进测试包设置
        testPackage.AddSetting("MyExternalObj", myExternalObj);

        // 3. 获取测试运行器并执行测试
        using var testRunner = engine.GetRunner(testPackage);
        // 用自定义监听器接收测试实时消息
        var testResult = testRunner.Run(new ConsoleTestListener(), TestFilter.Empty);

        // 4. 输出测试结果
        Console.WriteLine($"\n测试完成：总测试数{testResult.TestCount}，通过{testResult.PassCount}，失败{testResult.FailCount}");
    }
}

// 自定义测试监听器，用来打印测试过程中的消息
public class ConsoleTestListener : ITestEventListener
{
    public void OnTestEvent(string report)
    {
        // 这里可以解析NUnit的XML报告，简化的话直接打印关键信息
        Console.WriteLine(report);
    }
}

步骤3：WinForms里的适配 #

如果是WinForms应用，把测试逻辑放到按钮点击事件里，注意不要阻塞UI线程，用异步执行：

private async void btnRunTests_Click(object sender, EventArgs e)
{
    btnRunTests.Enabled = false;
    try
    {
        await Task.Run(() =>
        {
            // 把上面控制台的测试运行逻辑放这里
        });
    }
    finally
    {
        btnRunTests.Enabled = true;
    }
}

几个注意点 #

• 确保测试项目已编译，应用里的DLL路径要正确（可以用相对路径或者动态获取）。
• 如果外部对象是复杂类型，只要和测试项目在同一进程运行，直接传引用就行，不需要序列化。
• 测试运行完成后，记得处理TestResult对象，生成自定义报告或者日志。

内容的提问来源于stack exchange，提问作者Hewitt V S