单元测试项目无法识别Assert类扩展方法的问题排查

问题背景 #

在名为unit_test_library的单元测试项目中定义了AssertExtensions静态类，包含针对Assert类的扩展方法（如AssertVec3Equal），将该库引用到其他单元测试项目后，无法识别这些方法为Assert类的成员。环境为Visual Studio 2017 + .NET Framework 4.7.2。

定义的扩展类代码：

using Microsoft.VisualStudio.TestTools.UnitTesting;
using System;

namespace PdbLib
{
    public static class AssertExtensions
    {
        public static void AssertVec3Equal(this Assert assert, Vec3 expected, Vec3 actual, double tolerance, string message = "")
        {
            Assert.IsTrue(expected.DistanceTo(actual) <= tolerance, message);
        }

        public static void AssertVec3NotEqual(this Assert assert, Vec3 expected, Vec3 actual, double tolerance, string message = "")
        {
            Assert.IsTrue(expected.DistanceTo(actual) > tolerance, message);
        }

        public static void AssertVec3Equal2(this Assert assert, Vec3 expected, Vec3 actual, double tolerance, string message = "")
        {
            if (Math.Abs(expected.X - actual.X) >= tolerance)
            {
                throw new AssertFailedException($"{message} X-component is incorrect. Expected: {expected.X}, Actual: {actual.X}");
            }

            if (Math.Abs(expected.Y - actual.Y) >= tolerance)
            {
                throw new AssertFailedException($"{message} Y-component is incorrect. Expected: {expected.Y}, Actual: {actual.Y}");
            }

            if (Math.Abs(expected.Z - actual.Z) >= tolerance)
            {
                throw new AssertFailedException($"{message} Z-component is incorrect. Expected: {expected.Z}, Actual: {actual.Z}");
            }
        }
    }
}

测试代码中尝试调用的方式：

Assert.AssertVec3Equal(v0Before, v0After, 1e-5, "First CA should remain unchanged.");

问题根源 #

C#的扩展方法只能扩展实例类型，而Microsoft.VisualStudio.TestTools.UnitTesting.Assert是一个静态类，无法被实例化，因此不能作为扩展方法的this参数目标。你定义的扩展方法试图将方法绑定到Assert的实例上，但静态类没有实例，编译器无法识别这种调用方式。

解决方法 #

方案1：改为静态方法直接调用 #

修改AssertExtensions类，移除扩展方法的this关键字，将其改为普通静态方法：

public static class AssertExtensions
{
    public static void AssertVec3Equal(Vec3 expected, Vec3 actual, double tolerance, string message = "")
    {
        Assert.IsTrue(expected.DistanceTo(actual) <= tolerance, message);
    }

    // 其他方法同理修改...
}

然后在测试代码中通过类名直接调用：

AssertExtensions.AssertVec3Equal(v0Before, v0After, 1e-5, "First CA should remain unchanged.");

方案2：封装为自定义断言类（可选） #

如果希望保持类似Assert的调用风格，可以创建自己的静态断言类，无需依赖扩展：

public static class CustomAssert
{
    public static void Vec3Equal(Vec3 expected, Vec3 actual, double tolerance, string message = "")
    {
        Assert.IsTrue(expected.DistanceTo(actual) <= tolerance, message);
    }

    // 其他断言方法...
}

调用方式：

CustomAssert.Vec3Equal(v0Before, v0After, 1e-5, "First CA should remain unchanged.");

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