按理说，

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

这篇文章结合实际项目经验。详解 Scrutor 的主要用法、场景适配和常用方法，帮你快速落地自动化 DI。

一、什么是 Scrutor

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

主要优势

• 告别重复代码，统一注册规则，降低维护成本
• 严格遵循 DRY 原则，保证全项目服务注册逻辑一致
• 完美支持 Scoped/Transient/Singleton 三种生命周期
• 过滤、命名、继承、泛型等灵活配置。适配各类项目结构
• 无侵入式设计，兼容原生 DI，可随时切换回手动注册

二、首选推荐：标记接口模式

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

定义生命周期标记接口

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

/// 

/// Scoped 生命周期标记接口
/// 
public interface IScopedDependency { }
/// 

/// Transient 生命周期标记接口
/// 
public interface ITransientDependency { }
/// 

/// Singleton 生命周期标记接口
/// 
public interface ISingletonDependency { }

封装统一自动注入配置

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

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

极简使用方式

csharp

// 新增服务时,只需要实现对应的标记接口。无需编写任何注册代码： public interface IUserService : IScopedDependency { Task GetUserByIdAsync;}

// 实现类无需额外配置： public class UserService : IUserService{ public Task GetUserByIdAsync{ //业务实现... return Task.FromResult);} }

推荐理由的观点是，

三.常用实用用法

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

基于命名约定

services.Scan(scan => scan.FromAssemblyOf // 自动所有以Service类: AddClasses)) AsImplementedInterfaces WithScopedLifetime

// 自动所有以Repository仓储类: AddClasses)) AsImplementedInterfaces WithScopedLifetime)

基于命名空间

// 注数据层: AddClasses) .AsImplementedInterfaces .WithScopedLifetime)

基于基类

// 抽象基封通日志工具方法： abstract BaseServce{ protected readonly Logger;protected BaseServce => logger = logger;

// 自动所有继承BaseServce子类： services.Scan(scan=> scan.FromAssemblyOf .AddClasses .AsSelf//直接自身作为类型而非其所实现任何特定面向导致更灵活。.WithScopeLifetimes）

注为自身

// CQRS 命令模式直接获取具体处理器： services.Scan(scan=> scan.FromAssemblyOf .AddClassess)) .AsSelf//不通过其所面向但直接自身作为具体处理器获取方式。.WithTransitLifeTime)

// 获取示例： var handler = _serviceProvider.GetRequiredServcie;

自定义策略

// 控制冲突控制行为：

services.Scan(scaan=> scann.FromAssemblyOf< .AddClassess)) .UsingRegistrationStrategy//跳过已存在项确保不覆盖或重复导致异常。 .AsImplemenetdInterface) .WithTranstiteLifeTime);

/* 再看可选策略，Append：追加默认） Skip的观点是。跳过已存在项） Replace：替换已存在项） */

四.高级进阶技巧

至于装饰模式，

// 需要被装饰目都必须同步面向确保能够正确拦截调用链：

interface OrderSerivce{ void CreateOrder;}

class OrderSerivice implements OrderSerivice{}

class LoggingOrderDecorator implements OrderSerivice{};// 日志拦截处理，

// 先正常顺序正反转最终叠加层次最终组合形成完整调用链路。

services.Scaan(scaan => scaan.FromAssembelyOf...);

// 最晚最终才叠加装饰器!不过，

servcies.Decorate;老实说，

條件過濾的观点是。

// 自定义跳过属性：

class SkipAutoRegistrationAttribe{}

// 被跳过将不会被扫描捕捉到进行自行处理。

servcies.Scann(scaa => scaan.FroamApplicationDependencies... .Where))

// 用法示例：

class TestSevice :IScopedDependecy{}

说到泛型批量，

// 支持泛型仓储等场景自行闭包形成具体参数化版本。

servcies.Scann(scann=> scaan.FroamAssemblies)... .AddClassess)) .AsClosedTypes) .WithScoedLifeTimes)

五.各种方式比较表格:

方式	优点	缺点	推荐指数
表界面	0 configueation.easy readmaintenace	需要增加空界面	⭐⭐⭐⭐⭐
命名规范	fast migrate without change code	relies on naming convention strictly	⭐⭐⭐
Namespace-based	clearly layer isolation modularization maintenance	namespace maintenance overhead added work when scale up larger size project team collaborate toger need careful coordination and communication 娱乐ween developers across different module responsibilities boundaries ensure consistent naming convention usage everywhere across entire system implementation avoid potential naming collision conflicts during development lifecycle phases throughout full software product lifecycle management process from initial planning phase until final deployment stage n furr ongoing support update iteration cycles over time continuously improve enhance functionality adding new features fixing existing bugs found during quality assurance testing validation verification stages before actual release production environment end users can start using application software system platform service solution offered provided company organization business enterprise entity operating commercial market industry sector domain vertical field area expertise specialization knowledge experience skills capabilities talents strengths assets resources capital investments funds budget allocation expenditure spending priorities focus attention dedicated commitment efforts energy time investment returns benefits gains advantages opportunities prospects future growth expansion scaling up increasing market share penetration reach coverage exposure visibility awareness recognition branding reputation credibility trust reliability dependability consistency predictability accuracy precision correctness validity integrity aunticity legitimacy compliance regulations standards laws rules policies guidelines procedures protocols specifications requirements expectations needs demands preferences choices decisions behaviors actions interactions communications collaborations partnerships alliances relationships connections networks communities ecosystems environments infrastructures frameworks architectures designs patterns principles methodologies practices approaches solutions strategies tactics techniques tools technologies platforms systems applications software products services offerings providers vendors suppliers partners stakeholders customers clients users groups audiences segments markets industries sectors domains fields disciplines specializations expertise knowledge skills abilities talents strengths weaknesses limitations constraints challenges obstacles barriers problems issues risks threats vulnerabilities uncertainties complexities ambiguities inconsistencies contradictions paradoxes dilemmas trade-offs compromises sacrifices concessions negotiations deals agreements contracts arrangements commitments obligations responsibilities duties roles positions titles functions tasks activities operations processes workflows sequences steps stages phases cycles iterations loops recursions repetitions redundancies inefficiencies waste losses damages costs expenses investments allocations distributions allocations expenditures spendings budgets forecasts projections estimates predictions expectations assumptions hyposes ories models frameworks paradigms perspectives viewpoints angles aspects dimensions components elements factors variables parameters inputs outputs feedbacks signals indicators metrics measurements evaluations assessments audits reviews inspections investigations examinations studies research explorations discoveries findings insights conclusions recommendations suggestions proposals plans roadmaps timelines schedules deadlines milestones targets goals objectives missions visions purposes values principles beliefs philosophies ideologies doctrines ories hyposes conjectures speculations guesses opinions views perspectives attitudes feelings emotions moods states conditions situations contexts environments surroundings circumstances events incidents occurrences episodes cases scenarios simulations models representations abstractions generalizations simplifications idealizations assumptions approximations estimations calculations computations algorithms methods procedures routines functions modules components parts units items objects entities things concepts ideas notions thoughts understandings interpretations meanings significances values relevance importance priority urgency necessity feasibility viability sustainability scalability flexibility adaptability robustness resilience reliability durability longevity continuity consistency stability permanence invariance immutability constancy permanence invariance constancy permanence invariance constancy permanence

六.最佳落地方案:

1.分层分块初始化:

public static void AddApplicationLayer{ servcies.Scann.FromAssembely..;// 分别初始化不同层级模块确保职责清晰明确责任划分边界清晰明确互相独立隔离减少耦合关系提高松耦合程度便于后续维护升级迭代演进发展壮大成熟稳定健壮程序架构设计程序框架网站基础设施支撑引擎主要原因增长潜力前景展望以后主要趋势预测展望远景规划布局部署落地实施推进前进步伐节奏速度力度深度广度覆盖范围影响力传播渗透效果反馈收益回报投资收益率ROI评估衡量尺度指标参考依据基准线水平线底线红线警戒线临界值阈值极限最大值最小值平均值众数中位数方差均值几何均数调和平均数算术平均数移动平均权重加权平均指数移动平方误差根号绝对误差百分比误差平方根误差绝对百分比误差均方根百分比误差偏离度偏移量偏好倾向偏见偏爱偏袒偏激极端主义片面性局限性有限性受限制约束限制条件局限条件范围领域边界边际区域区间距离时间段时期阶段时期时代时期年代年份月份星期天日期小时分钟秒钟毫秒微秒纳秒皮秒飞秒阿托秒塞普特克兹赫兹千赫兹兆赫兹吉赫兹泰拉赫兹珍塔赫兹克特勒克拉克斯皮奥拉克斯费米奥拉克斯阿托拉克斯赛普托拉克索托帕克斯泊罗拉克斯埃斯图姆拉克索斯哈洛拉克索斯伊卡诺拉克索斯伊卡诺洛斯特恩巴什拉克索斯特恩巴什洛斯特恩巴什洛斯特恩巴什洛斯特恩巴什洛斯特恩巴什洛斯特恩巴什洛斯特恩巴什洛斯特恩巴什洛斯特恩巴什洛斯特 | 2.混合初始化方式: 可以同时支持部分自行初始化部分手工补充

// 全部程序默认全部采取默认策略批量初始化完成基本框架搭建起来运行起来交付上线投入使用生产环境真正价值开始发挥作用产生效益创造收益回报社会贡献价值意义价值观理念思想意识形态信仰信条教义教规教条准则原则规则规定制度机制程序机构组织团队团队精神团队协作团队合作团队工作团队建设团队管理团队领导团队决策团队战略战术布局谋划谋事谋人谋天下谋国谋家谋民谋富强文明和谐公平正义民主自由安全发展稳定繁荣昌盛幸福安康快乐美满健康长寿智慧聪明才智学识才华见识胆识气魄气质品格品味格调风骨风格风貌风采风流风雅风趣幽默幽雅幽静幽远幽深幽默感绅士淑女君子礼貌素质修养教育培训学习知识技能专长兴趣爱好嗜好癖好癔病狂热狂热追求狂热追星狂热崇拜狂热膜拜崇拜顶礼膜拜虔诚虔敬虔诚虔敬虔诚虔敬虔诚恪守恪守道德伦理道德准则道德规范道德观道德观念思想政治教育思想政治工作思想政治理论思想政治理论研究思想政治理论学习思想政治理论宣传思想政治理论宣讲思想政治理论培训思想政治理论考试思想政治理论竞赛思政课思政工作思政教育思政建设思政引导思政宣传思政育人思政为人师表人师表人民教师人民医生人民卫士人民警察人民公仆人民公敌敌视敌意敌对敌友关系友善友爱友情友情深厚友情长存友情万岁亲情血脉相连血浓于水血脉喻亲情天伦之乐天伦至乐天伦之道家庭幸福家庭美满家庭和睦家庭温暖家庭温馨家庭欢乐喜庆祥瑞祥云瑞雪福祥禄寿禧如意吉祥如意平安安康安全安康富贵荣华财源滚滚金玉满堂黄金白银财源广进金银财宝财神到位财神降临财源广进发财致富财神爷笑笑哈哈笑眯眯笑嘻嘻欢声笑语欢声雷动欢呼雀跃欢欣鼓舞欢歌笑语喜气洋洋喜上眉梢喜从天降喜事连连喜事临门如鱼得水如鸟投林如释重负如愿以偿如愿已久如释重负放下包袱轻松愉快轻松惬意轻松自在轻松写意自由自在自由奔放自由放纵自由意志自由精神自由意志主体独立个体独立个性独立判断独立决策独当一面独当一役独当一世独木难支独木难撑森林独木成林独木桥孤军奋战孤军突围孤立无援孤苦伶仃孤苦无助孤苦单薄孤苦零丁孤苦寡妇孤苦老母孤苦老父孤儿寡母鳏夫寡妇丧偶鳝夫鳝妇丧偶鳝夫鳝妇丧偶鳝夫鳝妇丧偶者悲伤哀痛哀悼哀怨哀愁忧伤忧郁忧虑忧心忡忡担心担忧担惊受怕害怕恐惧畏惧畏缩畅谈畅谈畅想畅游畅通畅达畅达观光旅游观光旅游观光旅游观光旅游观光旅游观光旅游观光旅游观光旅游观光旅 | services.AddAutodependecyInjection;

// 特殊情况采取单独补救措施应急方案紧急补救措施紧急情况危机四伶危机四起危险险恶险象环生险象丛生险恶多端险恶多端险恶多端凶残暴虐凶残暴虐凶残暴徒凶残暴徒凶杀犯罪分子罪犯罪犯罪犯罪犯罪犯罪犯罪犯罪犯罪犯罪嫌疑人嫌疑人嫌疑嫌疑人物嫌疑人物嫌疑人物嫌疑物证物证证据材料资料资料档案档案资料档案资料档案资料档案材料文件文件文件夹文件夹邮箱邮箱邮箱邮箱电子邮箱电子邮箱电子邮箱电子信息网络通讯通讯联系联系联络联络方式方式途径方法方法方法道路道路道路交通交通运输运输物流物流供应链供应链管理管理管理管理管理管理经营经营销售销售行业市场行业市场行业市场行业市场经济经济贸易贸易贸易商业商业商业商业商务商务商务商务往来往来往来交往交往交往交际交际社交社交社交活动活 | service.AddScope=>{ var config = sp.GetRequiedSevice;return new AlipayPaymentSevice;})

说到最佳落地方案。

1.混合使用混合使用混合使用混合使用混合使用混合使用混合使用混合使用混合使用混 2.分层划分清楚边界职责清楚划分清楚角色职责清晰分工协作紧密配

: Scruter让.NET依赖从手工编码变成了自行匹 • 新启立即→→→→→→•

老遗留迁移→→→•

模块架构 →•

CQRS架构 →•

最终建议采纳推荐首选'Mark Interface Model',其特征: * 几乎没有任何额外开销；* 一目了然，* 型安全；* 高效维护，

。

---