前言

在 Android 开发中，依赖注入 已经成为解耦与测试的主要手段。其实，虽然网上有不少教程。但很多人仍然感到：“我不明白 Hilt 是怎么工作的；配置多了就怕出错，如何把第三方库注入进去？说起来，”

1️⃣ 什么是依赖注入？

DI 的主要思想是：对象的创建与使用分离。它让你不必手动 new 对象，而是把需要的依赖交给框架来提供。

痛点 1： 初学者往往把“依赖”理解为外部类，却忽视了它是“被使用”而非“拥有”。

至于例子。卡车配送模型

@AndroidEntryPoint class MainActivity : ComponentActivity { @Inject lateinit var truck: Truck override fun onCreate { super.onCreate setContent { /* UI */ } truck.deliver } } class Truck @Inject constructor { fun deliver = println }

MainActivity 不关心 Truck 是怎么创建的，只需声明它就能直接使用。

2️⃣ Hilt 基础配置

① 添加版本、插件、库

hilt = "x.y.z"
ksp = "a.b.c"
hilt-android = { module = "com.google.dagger:hilt-android",version.ref = "hilt" }
hilt-compiler = { module = "com.google.dagger:hilt-compiler",version.ref = "hilt" }
hilt-android = { id = "com.google.dagger.hilt.android",version.ref = "hilt" }
ksp = { id = "com.google.devtools.ksp"。version.ref = "ksp" }

② 根目录 build.gradle.kts 声明别名

plugins {
alias apply false
alias apply false
}

③ App 模块 build.gradle.kts 应用插件并添加依赖

plugins {
alias
alias
}
dependencies {
implementation
ksp
}

④ 在 Application 上加 @HiltAndroidApp 注解

@HiltAndroidApp
class MyApplication : Application

痛点 2： 大量 Gradle 配置容易导致版本冲突或遗漏。记得检查所有模块是否都启用了同一版本的 Hilt。

3️⃣ 带参数的依赖注入

@AndroidEntryPoint
class MainActivity : ComponentActivity {
@Inject lateinit var truck: Truck
override fun onCreate {
super.onCreate
setContent { /* UI */ }
truck.deliver
}
}
class Truck @Inject constructor {
fun deliver =
println
}
class Driver @Inject constructor

如果 Truck 的构造函数里还有未被标记为 @Inject 的第三方对象，该怎么办？下面说明，

4️⃣ 第三方类的依赖注入

class Truck @Inject constructor {
fun deliver =
println
}
@Module
@InstallIn
class TimeModule {
@Provides
fun provideTimeZone: TimeZone =
TimeZone.getDefault
}

痛点 3： 未加 @Provides 的第三方类会导致编译错误。需要额外写 Module，记得按作用域安装到合适的位置。

5️⃣ 接口实现的绑定

interface Engine { fun start }
class GasEngine @Inject constructor : Engine {
override fun start =
println
}
@Module
@InstallIn
abstract class EngineModule {
@Binds abstract fun bindEngine: Engine
}
// 在使用处：
class Truck @Inject constructor {
@Inject lateinit var engine: Engine
fun deliver { engine.start }
}

痛点 4： 当接口有多实现时单纯用 @Binds 会报 DuplicateBindings，需要自定义 Qualifier。

6️⃣ 给同一接口提供不同实例

interface Cargo { fun description }
@Qualifier@Retention
annotation class BindFoodCargo
@QualifierRetention
annotation class BindPhoneCargo
class FoodCargo @Inject constructor : Cargo {
override fun description =
println
}
class PhoneCargo @Inject constructor : Cargo {
override fun description =
println
}
@Module
@InstallIn
abstract class CargoModule {
@BindFoodCargo
@Binds abstract fun bindFoodCargo: Cargo
@BindPhoneCargo
@Binds abstract fun bindPhoneCargo: Cargo
}
// 使用：
class Truck {
@BindFoodCargo
@Inject lateinit var foodCargo: Cargo
@BindPhoneCargo
@Inject lateinit var phoneCargo: Cargo
fun deliver{
foodCargo.description
phoneCargo.description
}
}

7️⃣ 作用域 Scope 与生命周期对应关系

• @SingletonComponent – 应用级别，全局单例。
• @ActivityRetainedComponent – Activity 生命周期但保留在配置变更后。老实说，
• @ViewModelComponent – ViewModel 生命周期。同 Activity 或 Fragment。
• @ActivityComponent – Activity 生命周期，配合 ViewBinding 等场景。
• @FragmentComponent – Fragment 生命周期。
• @ServiceComponent – Service 生命周期，仅限 Service 内使用。

每个作用域决定了对象能被注入到哪些入口还有能存活多久。若需跨多个组件共享同一实例，可将 Module 安装到更高级别的 Component。例如 SingletonComponent；否则可拆分成多 Module，以保持边界清晰。

8️⃣ ViewModel 的 DI

MVP / MVVM 中最常见的问题之一：ViewModel 与 Repository/UseCase 冗长地写构造函数。Hilt 提供专门支持 ViewModel 的注解和编译器，使得获取 ViewModel 更简洁。至于先添加依赖，

hiltLifecycleViewmodel ="x.y.z"

androidx-hlt-lifecycle-viewmodel={module ="androidx.hilt:hilt-lifecycle-viewmodel",version.ref =" hltLifecycleViewmodel"} androidx-hlt-compiler={module ="androidx.hiltt:hlt-lifecycle-compiler"。version.ref =" hltLifecycleViewmodel"}

dependencies { implementation ksp }

• 用 @HiltViewModel 注解标记 ViewModel，并直接通过 @Inject 注入所需对象。kotlin @HILTviewModel Class MyHvtLVM : ViewMoel{ fun getData: String=repo.getData } • 在 Activity/Fragment 中使用 by viewModels 或 by activityViewModels 即可，无需手动调用 ViewModelProvider。其实，kotlin @ANDROIDENTRYPOINT Class MainAct extends ComponentActy{

private val vm by viewModels //自动由 HILT 创建并缓存 } `` • **痛点5**：忘记添加 compiler 插件会导致 “Could not find symbol 'by viewModels'”。或者错误提示 “No binding found for…”，这时检查是否已导入androidx-hilkt-lifecycle-viewmodel` 和对应 compiler。

@HILTviewModel + by viewModels 把传统繁琐的 ViewModel 创建过程隐藏。让你专注业务逻辑，而不是框架细节。

⚠️ 小结 | 常见问题快速定位表

场景	常见错误	排查顺序
Gradle 配置缺失	Unresolved reference 或 Could not find symbol	检查 libs 别名、插件是否 applied
Scope 错误	Multiple bindings for type	确认 Module 安装到正确 Component
第三方库未提供	DAGGER/DuplicateBindings / No Binding found	写对应 Module 并标记 @Provides 或 @Binds
ViewModel 未生成	Cannot find symbol 'by viewModels'	确认已引入 lifecycle-viewmodel + compiler
Runtime 崩溃	NPE on field after injection	确认入口类已加 @AndroidEntryPoint 并重新生成 Dagger graph

此表可作为日常排错快捷键，减少重复调试时间。

---

🎯 最终提示

1. 先读官方文档了解各个 Component 的生命周期与默认作用域。
2. 模块化思路每个功能拆成独立 Module，避免大而全造成维护成本。
3. 调试工具开启 后可在 logcat 查看 Dagger graph 信息。
4. 持续实践把上述示例逐步迁移到现有项目中。一旦真正用起来再回头看源码，就能彻底消除“只懂说说”的疑虑。

祝你在 Android 项目中愉快地玩转 HILT 🚀

---