为何同一类中定义的IServiceCollection扩展方法AddSwagger无法被识别？

将扩展方法封装在Program类中时，IDE报错：

'IServiceCollection' does not contain a definition for 'AddSwagger' and no accessible extension method 'AddSwagger' accepting a first argument of type 'IServiceCollection' could be found (are you missing a using directive or an assembly reference?)

代码示例：

public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);

        builder.Services.AddControllers();
        builder.Services.AddEndpointsApiExplorer();
        builder.Services.AddSwagger(); // 此处报错
        builder.Services.AddProblemDetails();

        ...
    }

    public static IServiceCollection AddSwagger(this IServiceCollection services)
    {
        return services.AddSwaggerGen(options =>
        {
            options.AddSecurityDefinition("oauth2", new OpenApiSecurityScheme
            {
                Description = "Standard Authorization header using the Bearer scheme (\"Bearer {token}\")",
                In = ParameterLocation.Header,
                Name = "Authorization",
                Type = SecuritySchemeType.ApiKey
            });

            options.OperationFilter<SecurityRequirementsOperationFilter>();
        });
    }
}

将该方法移至其他类中则可正常运行，请问原因是什么？

核心问题：扩展方法定义不符合C#语法规范 #

C#对扩展方法有硬性要求：扩展方法必须定义在非嵌套、非泛型的静态类中。

你的代码里，AddSwagger方法虽然满足「静态方法」「第一个参数带this修饰符」这两个条件，但它所在的Program类是普通非静态类，因此编译器不会将其识别为有效的扩展方法，自然无法通过IServiceCollection实例的.语法调用它。

移至其他类可正常运行的原因 #

当你把AddSwagger移到其他类时，通常会将目标类定义为静态类（比如public static class SwaggerServiceExtensions），这就完全符合扩展方法的定义规范：

• 包含扩展方法的类是静态类
• 方法本身是静态的，且第一个参数带this修饰符
  此时编译器会正确识别它为IServiceCollection的扩展方法，调用时也就不会报错。

额外验证：若非要留在Program类的处理方式 #

如果硬要把这个方法留在Program类中，不能用扩展方法的语法调用，只能直接当作静态方法调用：

Program.AddSwagger(builder.Services);

但这种写法失去了扩展方法的语法便利性，更推荐遵循编码规范，将扩展方法单独放在静态类中。

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