如何让C#编译器不显示扩展方法的空检查警告？

要让自定义扩展方法和string.IsNullOrWhiteSpace一样不触发绿色波浪线警告，核心是通过Nullable静态分析特性告知编译器方法参数与返回值的关联逻辑，具体实现步骤如下：

1. 引入必要命名空间 #

首先需要添加System.Diagnostics.CodeAnalysis命名空间，该空间包含用于静态分析的关键特性：

using System.Diagnostics.CodeAnalysis;

2. 给扩展方法添加特性标记 #

针对自定义的空白检查扩展方法，使用[NotNullWhen]特性标记返回值与参数的关系，搭配[Pure]标记方法为纯函数（无状态修改、无副作用），让编译器能准确识别参数的非null状态：

示例代码：

public static class StringExtensions
{
    [Pure]
    [return: NotNullWhen(false)]
    public static bool IsNullOrWhiteSpace(this string? str)
    {
        // 这里可以替换为你的自定义空白判断逻辑
        return string.IsNullOrWhiteSpace(str);
    }
}

特性作用说明： #

• [Pure]：标记方法为纯函数，仅返回结果不修改外部状态，帮助编译器优化静态分析逻辑。
• [NotNullWhen(false)]：明确告知编译器——当方法返回false时，传入的str参数一定不为null且非空白字符串。后续代码中使用该参数时，编译器会自动取消“可能为null”的警告。

3. 验证效果 #

添加特性后，使用自定义扩展方法的代码将和调用string.IsNullOrWhiteSpace的表现完全一致，不会再出现不必要的绿色波浪线警告：

string? testStr = GetSomeString();
if (!testStr.IsNullOrWhiteSpace())
{
    // 编译器自动识别testStr不为null，无警告
    Console.WriteLine(testStr.Length);
}

如果你的扩展方法有自定义的空白判断规则，只需保证[NotNullWhen]的布尔值与返回逻辑匹配即可（比如方法返回true表示字符串有效时，使用[NotNullWhen(true)]）。

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