Scrutor：.NET 依赖注入自动化的优雅实现
在现代 .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>>();五、各注册方式对比
| 注册方式 | 优点 | 缺点 | 推荐指数 |
|---|---|---|---|
| 标记接口 | 零配置、可读性高、编译期检查 | 需要定义空接口 | ⭐⭐⭐⭐⭐ |
| 命名约定 | 无需改代码、快速迁移 | 强依赖命名规范 | ⭐⭐⭐ |
| 命名空间 | 分层清晰、模块化管理 | 需维护命名空间 | ⭐⭐⭐⭐ |
| 基类继承 | 统一通用逻辑 | 类耦合度偏高 | ⭐⭐⭐ |
| 注册自身 | 适配 CQRS 模式 | 面向实现编程，灵活性低 | ⭐⭐⭐ |
六、落地最佳实践
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 项目的标配实践。