Angular 的依赖注入（DI）是其核心特性之一，它通过松耦合的方式实现组件、服务之间的依赖管理，让代码更易维护、测试和扩展。而依赖注入的灵活性，很大程度上体现在注入令牌（Injection Token）的配置上 ——useClass、useValue、useFactory这三个核心配置项，分别对应不同的场景需求。本文将深入解析这三者的特性，并结合实战场景说明其灵活应用方式。
一、先搞懂：依赖注入令牌的核心逻辑
在 Angular 中，注入令牌（InjectionToken）是 DI 系统识别依赖的 “标识”，而useClass、useValue、useFactory则是告诉 DI 系统：当请求这个令牌时，该如何创建 / 提供对应的实例 / 值。
简单来说：
- 令牌是 “钥匙”，三个配置项是 “钥匙对应的锁里该放什么”；
- 不同配置项适配不同的 “值类型” 和 “创建逻辑”。
二、useClass：类实例的灵活替换
核心特性
useClass表示：当注入令牌被请求时，DI 系统会创建指定类的实例并注入。它的核心价值是类的替换与多态—— 同一个令牌可以绑定不同的类，实现 “接口不变、实现替换”。
适用场景
1. 基础场景：默认类注入（最常用）
这是useClass最基础的用法，直接绑定令牌到具体类，DI 系统自动实例化。
示例：基础服务注入
// 定义核心服务 export class LoggerService { log(message: string) { console.log(`[默认日志] ${message}`); } } // 模块中配置注入 @NgModule({ providers: [ // 简写形式，等价于 { provide: LoggerService, useClass: LoggerService } LoggerService ] }) export class CoreModule {} // 组件中注入使用 @Component({ selector: 'app-demo' }) export class DemoComponent { constructor(private logger: LoggerService) { this.logger.log('组件初始化'); // 输出：[默认日志] 组件初始化 } }2. 进阶场景：类的替换（多态 / 环境适配）
最能体现useClass价值的场景是 “替换实现”—— 比如开发环境用模拟服务，生产环境用真实服务；或者不同业务模块用不同的实现类。
示例：环境适配的日志服务
// 定义抽象基类/接口（推荐用抽象类，Angular DI不直接支持接口） export abstract class LoggerService { abstract log(message: string): void; } // 开发环境实现 export class DevLoggerService extends LoggerService { log(message: string) { console.log(`[DEV日志] ${message}`); } } // 生产环境实现 export class ProdLoggerService extends LoggerService { log(message: string) { // 生产环境：上报到日志服务器 fetch('/api/log', { method: 'POST', body: JSON.stringify({ message }) }); } } // 模块中根据环境配置 @NgModule({ providers: [ { provide: LoggerService, useClass: environment.production ? ProdLoggerService : DevLoggerService } ] }) export class CoreModule {}3. 实战场景：第三方服务的封装替换
当项目中使用第三方库的服务，但后续需要替换为自研实现时，useClass可以保证业务代码无感知。
注意点
useClass绑定的类必须有可注入的构造函数（无参，或参数都能被 DI 解析）；- 替换的类需遵循 “里氏替换原则”，保证接口一致。
三、useValue：静态值 / 常量的注入
核心特性
useValue直接绑定一个静态值 / 常量 / 对象实例，DI 系统不会创建新实例，而是直接返回这个值。适用于注入配置项、常量、固定对象等场景。
适用场景
1. 注入环境配置 / 常量
项目中的固定配置（如 API 地址、超时时间、主题色）适合用useValue注入，便于统一管理和修改。
示例：注入 API 配置
// 定义令牌 export const API_CONFIG = new InjectionToken('API_CONFIG'); // 模块中配置 @NgModule({ providers: [ { provide: API_CONFIG, useValue: { baseUrl: 'https://api.example.com', timeout: 5000, version: 'v2' } } ] }) export class AppModule {} // 组件/服务中注入使用 @Component({ selector: 'app-api-demo' }) export class ApiDemoComponent { constructor(@Inject(API_CONFIG) private apiConfig: any) { console.log('API基础地址：', this.apiConfig.baseUrl); // 输出：https://api.example.com } }2. 注入固定对象 / 模拟数据
测试场景中，可通过useValue注入模拟数据，替代真实服务的返回值。
示例：测试时注入模拟数据
// 测试模块配置 TestBed.configureTestingModule({ providers: [ { provide: UserService, useValue: { getUser: () => ({ id: 1, name: '测试用户' }) // 模拟方法返回固定值 } } ] });3. 注入函数 / 回调
useValue也可注入函数，实现 “动态回调” 的注入。
export const ERROR_HANDLER = new InjectionToken('ERROR_HANDLER'); @NgModule({ providers: [ { provide: ERROR_HANDLER, useValue: (error: Error) => { console.error('全局错误处理：', error.message); // 额外逻辑：上报错误、显示提示等 } } ] }) export class CoreModule {}注意点
useValue绑定的是 “值的引用”，修改原对象会影响注入的值（建议用不可变对象）；- 不适合注入需要动态创建的实例（优先用
useFactory）。
四、useFactory：动态创建实例 / 值
核心特性
useFactory绑定一个工厂函数，DI 系统会调用这个函数，并将函数的返回值作为注入结果。它的核心价值是：
- 支持依赖其他服务来动态创建实例；
- 支持条件逻辑、异步创建（配合
multi或useFactory+Promise）； - 实现更复杂的实例创建逻辑。
适用场景
1. 依赖其他服务的动态创建
工厂函数可以注入其他服务，基于依赖的值动态生成实例 / 值。
示例：根据用户权限动态创建权限服务
// 定义权限服务接口 export abstract class PermissionService { abstract hasPermission(permission: string): boolean; } // 管理员权限实现 export class AdminPermissionService extends PermissionService { hasPermission(permission: string): boolean { return true; // 管理员拥有所有权限 } } // 普通用户权限实现 export class UserPermissionService extends PermissionService { hasPermission(permission: string): boolean { return ['read', 'comment'].includes(permission); } } // 工厂函数：依赖UserService，动态返回对应权限服务 export function permissionServiceFactory(userService: UserService): PermissionService { return userService.isAdmin() ? new AdminPermissionService() : new UserPermissionService(); } // 模块配置 @NgModule({ providers: [ UserService, { provide: PermissionService, useFactory: permissionServiceFactory, deps: [UserService] // 声明工厂函数依赖的服务（DI会自动注入） } ] }) export class AuthModule {}2. 异步创建实例
Angular 14 + 支持useFactory返回Promise或Observable，配合inject函数实现异步注入（适合需要异步加载配置的场景）。
示例：异步加载 API 配置
export const API_CONFIG = new InjectionToken('API_CONFIG', { factory: async () => { const configService = inject(ConfigLoaderService); return await configService.loadApiConfig(); // 异步加载配置 } }); // 组件中使用（需用inject函数，或在ngOnInit中等待） @Component({ selector: 'app-async-demo' }) export class AsyncDemoComponent implements OnInit { apiConfig: any; async ngOnInit() { this.apiConfig = await inject(API_CONFIG); } }3. 复杂逻辑的实例创建
当实例创建需要多步逻辑、条件判断、参数拼接时，useFactory是最佳选择。
示例：创建带自定义配置的 HTTP 拦截器
export function authInterceptorFactory( authService: AuthService, apiConfig: any ): HttpInterceptor { // 复杂逻辑：拼接token、设置超时、添加自定义头 return new AuthInterceptor(authService.getToken(), apiConfig.timeout); } @NgModule({ providers: [ { provide: HTTP_INTERCEPTORS, useFactory: authInterceptorFactory, deps: [AuthService, API_CONFIG], multi: true // 多拦截器需设置multi: true } ] }) export class HttpModule {}注意点
deps数组需与工厂函数的参数顺序一致，DI 会按顺序注入依赖；- 异步工厂函数返回的
Promise会被 DI 解析，注入时需等待完成； multi: true可配置多个相同令牌的注入（如多个 HTTP 拦截器）。
五、三者对比与选型建议
| 配置项 | 核心能力 | 适用场景 | 关键特点 |
|---|---|---|---|
| useClass | 创建 / 替换类实例 | 服务实现替换、多态、环境适配 | DI 自动实例化，支持继承 |
| useValue | 注入静态值 / 常量 / 固定对象 | 配置项、常量、模拟数据、固定函数 / 回调 | 无实例创建，直接返回值 |
| useFactory | 动态创建实例 / 值 | 依赖其他服务、异步创建、复杂逻辑创建 | 支持自定义逻辑，可依赖其他服务 |
选型口诀
- 要 “类实例” 且需替换 →
useClass； - 要 “固定值 / 常量” →
useValue； - 要 “动态创建 / 依赖其他服务 / 异步” →
useFactory。
六、总结
Angular DI 的useClass、useValue、useFactory看似简单，实则是实现 “松耦合、高扩展” 的关键：
useClass让我们可以灵活替换服务实现，适配不同场景；useValue让配置和常量的管理更统一，便于测试和修改；useFactory则解决了复杂逻辑下的实例创建问题，支持依赖联动和异步加载。
掌握这三者的核心场景和使用技巧，能让 Angular 项目的依赖管理更清晰、更灵活，尤其是在大型项目中，合理的 DI 配置能大幅降低代码耦合度，提升可维护性。
最后记住：DI 的核心是 “解耦”，选择哪种配置项，本质是看 “需要注入的是类实例、静态值，还是动态生成的值”—— 贴合场景的选择，才是最优解。
