C#的依赖注入(DI)是什么?面向初学者的DI核心概念与实例教程

煙雲

煙雲

2025-11-24

568人浏览

原创

依赖注入通过外部注入对象实现解耦,提升代码可测试性与维护性。示例中UserService不再自行创建UserDataAccess,而是通过构造函数接收IUserDataAccess实现,.NET内置容器在Program.cs中注册服务生命周期(Scoped/Singleton/Transient),运行时自动注入实例,测试时可替换为Mock对象,避免硬编码依赖,统一管理对象创建,降低耦合度。

c#的依赖注入(di)是什么?面向初学者的di核心概念与实例教程

依赖注入(Dependency Injection,简称 DI)是 C# 和 .NET 开发中一个非常重要的设计模式。它帮助我们写出更松耦合、更容易测试和维护的代码。如果你刚接触这个概念,可能会觉得抽象,但其实它的核心思想很简单:不要自己创建对象,而是让外部系统把需要的对象“送进来”。

什么是依赖?

面向对象编程中,一个类经常需要使用另一个类的功能。比如,有一个 UserService 类需要访问数据库,它可能依赖于一个 UserDataAccess 类。这种“需要别人帮忙完成工作”的关系就是“依赖”。

示例:

假设你有一个用户服务类:

public class UserService
{
    private UserDataAccess _dataAccess;
<pre class="brush:php;toolbar:false;">public UserService()
{
    _dataAccess = new UserDataAccess(); // 手动创建依赖
}

public string GetUser(int id)
{
    return _dataAccess.GetUserById(id);
}

}

这里的问题是:UserService 自己创建了 UserDataAccess,导致两者紧紧绑在一起。如果将来想换成 Mock 数据或不同的实现,就必须修改代码 —— 这不利于测试和扩展。

依赖注入的核心思想

DI 的基本思路是:把依赖项从外部“注入”进来,而不是在类内部自己 new 出来。最常见的方式是通过构造函数传入。

改写上面的例子:

public class UserService
{
    private readonly IUserDataAccess _dataAccess;
<pre class="brush:php;toolbar:false;">public UserService(IUserDataAccess dataAccess)  // 依赖通过构造函数传入
{
    _dataAccess = dataAccess;
}

public string GetUser(int id)
{
    return _dataAccess.GetUserById(id);
}

}

现在,UserService 不关心具体是谁提供数据访问功能,只要对方符合 IUserDataAccess 接口就行。这就实现了“解耦”。

.NET 中的内置 DI 容器

.NET Core 及以后版本内置了依赖注入容器,可以在程序启动时注册服务,并自动把它们注入到需要的地方。

步骤如下:

ApiPost接口调试与文档生成工具
ApiPost接口调试与文档生成工具

ApiPost是一个支持团队协作,支持模拟POST、GET、PUT等常见请求,并可直接生成文档的API调试、管理工具,ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具,ApiPost官方版界面美观大方,功能强劲实用,支持团队协作,支持模拟POST、GET、PUT等常见请求,是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键

下载
  • 定义接口和实现
  • Program.csStartup.cs 中注册服务
  • 在类中通过构造函数接收依赖

完整示例:

// 1. 定义接口
public interface IUserDataAccess
{
    string GetUserById(int id);
}
<p>// 2. 实现接口
public class UserDataAccess : IUserDataAccess
{
public string GetUserById(int id)
{
return $"User {id} from database";
}
}</p><p>// 3. 使用依赖的服务
public class UserService
{
private readonly IUserDataAccess _dataAccess;</p><pre class="brush:php;toolbar:false;">public UserService(IUserDataAccess dataAccess)
{
    _dataAccess = dataAccess;
}

public string GetUser(int id)
{
    return _dataAccess.GetUserById(id);
}

}

Program.cs(.NET 6+)中注册服务:

var builder = WebApplication.CreateBuilder(args);
<p>// 注册服务:告诉容器 IUserDataAccess 应该用 UserDataAccess 来实例化
builder.Services.AddScoped<iuserdataaccess userdataaccess>();
builder.Services.AddScoped<userservice>();</userservice></iuserdataaccess></p><p>var app = builder.Build();</p><p>// 示例:在 Minimal API 中使用
app.MapGet("/user/{id}", (int id, UserService userService) =>
{
return userService.GetUser(id);
});</p><p>app.Run();
</p>

当你访问 /user/1 时,.NET 会自动创建 UserService 实例,并把已注册的 IUserDataAccess 实现注入进去。

三种常见的服务生命周期

注册服务时,你需要选择它的生命周期:

  • Scoped:每次 HTTP 请求创建一次(适用于 Web 应用)
  • Singleton:整个程序运行期间只创建一次
  • Transient:每次请求都创建新实例

一般情况下:

  • 数据访问类用 Scoped
  • 工具类或无状态服务可用 Singleton
  • 轻量级、有状态的临时对象可用 Transient

为什么使用 DI?好处有哪些?

  • 易于测试:你可以注入 Mock 对象进行单元测试
  • 解耦代码:类之间不再硬编码依赖关系
  • 便于维护:更换实现时只需修改注册代码,无需改动业务类
  • 统一管理对象创建:避免手动 new 导致的资源浪费或错误

举个测试的例子:

// 测试时可以注入一个假的数据访问层
public class MockUserDataAccess : IUserDataAccess
{
    public string GetUserById(int id) => $"Mock User {id}";
}
<p>// 单元测试中
var mockDataAccess = new MockUserDataAccess();
var userService = new UserService(mockDataAccess); // 注入模拟对象
var result = userService.GetUser(1);
Console.WriteLine(result); // 输出: Mock User 1
</p>

这样不需要真实数据库就能测试逻辑。

基本上就这些。依赖注入不是魔法,它只是一个帮你更好地组织代码的工具。刚开始可能会觉得多写了不少接口和注册代码,但随着项目变大,你会发现它带来的清晰结构和灵活性非常值得。

相关专题

更多
go语言 面向对象
go语言 面向对象

本专题整合了go语言面向对象相关内容,阅读专题下面的文章了解更多详细内容。

2025.09.05

2053

14

java面向对象
java面向对象

本专题整合了java面向对象相关内容,阅读专题下面的文章了解更多详细内容。

2025.11.27

153

13

C++ 面向对象编程与设计模式实践
C++ 面向对象编程与设计模式实践

本专题整合了 C++ 面向对象编程的核心机制,涵盖类的定义与访问控制、构造函数与析构函数、拷贝语义与移动语义、继承与虚函数多态、抽象类与接口、运算符重载、友元函数等关键知识点,同时结合单例模式、工厂模式、观察者模式、策略模式等常用设计模式的 C++ 实现,帮助开发者写出结构清晰、易于维护的面向对象代码。

2026.04.09

91

30

Java 面向对象与核心编程机制
Java 面向对象与核心编程机制

系统讲解 Java 面向对象编程的核心知识体系,涵盖类的定义与封装、构造方法与 this/super 关键字、继承与方法重写、多态与向上向下转型、抽象类与接口的区别与设计原则、异常处理机制(try-catch-finally / 自定义异常)、泛型的类型参数与通配符、集合框架(List/Set/Map)的使用与遍历方式,帮助开发者全面掌握 Java 程序设计的核心机制与面向对象思维。

2026.04.17

81

15

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

2768

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

2145

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3364

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

160

15

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

2023.06.29

1284

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Fitten Code官方手册
Fitten Code官方手册

共0课时 | 0人学习

CodeGeex使用手册
CodeGeex使用手册

共0课时 | 0人学习

通义灵码手册
通义灵码手册

共0课时 | 0人学习