在现代 .NET 开发中，依赖注入（DI）已经成为标配功能。手动注册每一个服务，不仅代码繁琐、重复度高，还容易出现漏注册、错注册的问题，给项目维护带来负担。Scrutor是一款轻量的 NuGet 扩展库，基于约定优于配置的思想，让 .NET 依赖注入实现全自动注册，大幅简化开发流程。

本文结合实际项目经验，详解 Scrutor 的核心用法、场景适配和最佳实践，帮你快速落地自动化 DI。

一、什么是 Scrutor

Scrutor 由开发者 Kristian Hellang 打造，是 ASP.NET Core 原生 DI 容器的扩展库。它不改变原生 DI 的核心逻辑，只提供程序集扫描、批量筛选、自动注册的能力，让服务注册从手动编写变成自动匹配。

核心优势

• 告别重复代码，统一注册规则，降低维护成本

• 严格遵循 DRY 原则，保证全项目服务注册逻辑一致

• 完美支持 Scoped/Transient/Singleton 三种生命周期

• 过滤、命名、继承、泛型等灵活配置，适配各类项目结构

• 无侵入式设计，兼容原生 DI，可随时切换回手动注册

二、首选推荐：标记接口模式（企业级最佳实践）

这是我在实际项目中长期使用的方案，简洁、易维护、可读性强，也是中大型项目的最优选择。

2.1 定义生命周期标记接口

先创建三个空接口，仅用于标记服务的生命周期，无任何业务逻辑：

/// <summary> /// Scoped 生命周期标记接口 /// </summary> public interface IScopedDependency { } /// <summary> /// Transient 生命周期标记接口 /// </summary> public interface ITransientDependency { } /// <summary> /// Singleton 生命周期标记接口 /// </summary> public interface ISingletonDependency { }

2.2 封装统一自动注入配置

写一个扩展方法，一次性完成所有标记服务的扫描注册，后续无需修改：

public static class DependencyInjectionExtensions { public static IServiceCollection AddAutoDependencyInjection(this IServiceCollection services) { // 扫描项目所有程序集，自动匹配标记接口的服务 services.Scan(scan => scan .FromApplicationDependencies() // 注册 Scoped 服务 .AddClasses(classes => classes.AssignableTo<IScopedDependency>()) .AsImplementedInterfaces() .WithScopedLifetime() // 注册 Transient 服务 .AddClasses(classes => classes.AssignableTo<ITransientDependency>()) .AsImplementedInterfaces() .WithTransientLifetime() // 注册 Singleton 服务 .AddClasses(classes => classes.AssignableTo<ISingletonDependency>()) .AsImplementedInterfaces() .WithSingletonLifetime() ); return services; } }

2.3 极简使用方式

新增服务时，只需要实现对应的标记接口，无需编写任何注册代码：

// 业务接口继承 IScopedDependency，标记生命周期 public interface IUserService : IScopedDependency { Task<UserInfo> GetUserByIdAsync(Guid userId); } // 实现类无需额外配置 public class UserService : IUserService { public Task<UserInfo> GetUserByIdAsync(Guid userId) { // 业务实现 return Task.FromResult(new UserInfo()); } }

推荐理由

• 零配置：新增服务只加一个接口，完全不用管注册逻辑

• 高可读：一眼就能看出服务的生命周期，代码自解释

• 强类型：编译期检查，避免运行时注册错误

• 易维护：全项目统一规则，新人上手无成本

三、常用实用用法

除了标记接口，Scrutor 还支持多种扫描规则，适配不同项目场景。

3.1 基于命名约定注册

适合命名规范严格的现有项目，按类名后缀批量注册：

services.Scan(scan => scan .FromAssemblyOf<Program>() // 自动注册所有以 Service 结尾的类 .AddClasses(classes => classes.Where(type => type.Name.EndsWith("Service"))) .AsImplementedInterfaces() .WithScopedLifetime() // 自动注册所有以 Repository 结尾的仓储类 .AddClasses(classes => classes.Where(type => type.Name.EndsWith("Repository"))) .AsImplementedInterfaces() .WithScopedLifetime() );

3.2 基于命名空间注册

适合按模块分层的项目，按命名空间批量注册：

services.Scan(scan => scan .FromAssemblyOf<Program>() // 注册应用服务层 .AddClasses(classes => classes.InNamespaces("MyProject.Application.Services")) .AsImplementedInterfaces() .WithScopedLifetime() // 注册数据仓储层 .AddClasses(classes => classes.InNamespaces("MyProject.Infrastructure.Repositories")) .AsImplementedInterfaces() .WithScopedLifetime() );

3.3 基于基类注册

适合封装通用基类的项目，批量注册继承基类的所有子类：

// 抽象基类，封装通用日志、工具方法 public abstract class BaseService { protected readonly ILogger<BaseService> _logger; protected BaseService(ILogger<BaseService> logger) => _logger = logger; } // 自动扫描注册所有继承 BaseService 的类 services.Scan(scan => scan .FromAssemblyOf<BaseService>() .AddClasses(classes => classes.InheritedFrom<BaseService>()) .AsSelf() .WithScopedLifetime() );

3.4 注册为自身类型

适合CQRS 命令/查询模式，直接注册实现类本身：

services.Scan(scan => scan .FromAssemblyOf<Program>() .AddClasses(classes => classes.AssignableTo<ICommandHandler>()) .AsSelf() // 不注册接口，直接注册类本身 .WithTransientLifetime() ); // 使用时直接获取实现类 var handler = _serviceProvider.GetRequiredService<CreateUserCommandHandler>();

3.5 自定义注册策略

控制重复服务的注册行为，避免冲突：

services.Scan(scan => scan .FromAssemblyOf<Program>() .AddClasses(classes => classes.AssignableTo<IValidator>()) .UsingRegistrationStrategy(RegistrationStrategy.Skip) // 跳过已存在的注册 .AsImplementedInterfaces() .WithTransientLifetime() );

可选策略：

• Append：追加注册（默认）

• Skip：跳过已注册服务

• Replace：替换已注册服务

四、高级进阶用法

4.1 装饰器模式

Scrutor 原生支持装饰器，轻松实现日志、缓存、事务等横切逻辑：

// 核心服务 + 装饰器都实现同一接口 public interface IOrderService { void CreateOrder(); } public class OrderService : IOrderService { } public class LoggingOrderDecorator : IOrderService { } // 先注册核心服务 services.Scan(scan => scan.FromAssemblyOf<IOrderService>().AddClasses().AsImplementedInterfaces().WithScopedLifetime()); // 叠加装饰器（执行顺序：后注册的先执行） services.Decorate<IOrderService, LoggingOrderDecorator>();

4.2 条件过滤注册

通过特性标记，跳过不需要自动注册的服务：

// 自定义跳过特性 [AttributeUsage(AttributeTargets.Class)] public class SkipAutoRegistrationAttribute : Attribute { } // 扫描时排除标记类 services.Scan(scan => scan .FromApplicationDependencies() .AddClasses(classes => classes .AssignableTo<IScopedDependency>() .Where(t => !t.HasAttribute<SkipAutoRegistrationAttribute>()) ) .AsImplementedInterfaces() .WithScopedLifetime() ); // 使用：标记无需自动注册的类 [SkipAutoRegistration] public class TestService : IScopedDependency { }

4.3 批量注册泛型服务

适配仓储模式等泛型接口，自动注册封闭泛型：

services.Scan(scan => scan .FromAssemblyOf<IRepository<>>() .AddClasses(classes => classes.AssignableTo(typeof(IRepository<>))) .AsClosedTypesOf(typeof(IRepository<>)) .WithScopedLifetime() ); // 直接使用 var userRepo = _serviceProvider.GetRequiredService<IRepository<User>>();

五、各注册方式对比

六、落地最佳实践

6.1 分层扫描注册

按项目架构分层注册，职责清晰，便于排查问题：

// 应用层注册 public static IServiceCollection AddApplicationLayer(this IServiceCollection services) { services.Scan(scan => scan .FromAssemblyOf<ApplicationLayerMarker>() .AddClasses(classes => classes.AssignableTo<IScopedDependency>()) .AsImplementedInterfaces() .WithScopedLifetime() ); return services; } // 基础设施层注册 public static IServiceCollection AddInfrastructureLayer(this IServiceCollection services) { services.Scan(scan => scan .FromAssemblyOf<InfrastructureLayerMarker>() .AddClasses(classes => classes.AssignableTo<IRepository>()) .AsImplementedInterfaces() .WithScopedLifetime() ); return services; }

6.2 自动+手动注册配合

自动注册通用服务，手动注册特殊配置服务：

// 批量自动注册 services.AddAutoDependencyInjection(); // 手动注册特殊服务（带自定义配置） services.AddScoped<IPaymentService>(sp => { var config = sp.GetRequiredService<IOptions<PaymentConfig>>(); return new AlipayPaymentService(config.Value.AppId); });

6.3 测试环境适配

单元测试中，直接用 Mock 覆盖自动注册的服务：

// 测试项目重写注册 services.AddScoped<IUserService, MockUserService>(); services.AddScoped<IOrderService, MockOrderService>();

七、总结

Scrutor 让 .NET 依赖注入从手动编码变成自动匹配，不同注册方式对应不同项目场景：

• 新项目搭建 →标记接口模式（首选）

• 老项目迁移 →命名约定模式

• 模块化架构 →命名空间模式

• CQRS 架构 →注册自身模式

标记接口模式是最推荐的方案，它兼顾简洁性、可读性和可维护性，能显著提升开发效率，降低团队协作成本，是企业级 .NET 项目的标配实践。