一、定位CoilCoroutine Image Loader是一个纯 Kotlin 协程实现的图片加载库核心卖点轻量体积只有 Glide 的约 1/5、API 现代Kotlin 优先、DSL 风格、Jetpack Compose 的官方搭档AsyncImage 就是 Coil 提供的。Google 官方在 Compose 文档中推荐的就是它。Coil 协程调度 责任链Interceptor 二级缓存内存 LruCache 磁盘 可插拔流水线Mapper/Fetcher/Decoder/Transformation二、基本用法View 体系一行扩展函数imageView.load(https://example.com/pic.jpg){placeholder(R.drawable.loading)// 加载中占位error(R.drawable.error)// 失败占位crossfade(true)// 淡入过渡transformations(CircleCropTransformation())// 圆形裁剪}Compose标准姿势AsyncImage(modelImageRequest.Builder(LocalContext.current).data(https://example.com/pic.jpg).crossfade(true).build(),contentDescriptionnull,modifierModifier.size(200.dp),placeholderpainterResource(R.drawable.loading),errorpainterResource(R.drawable.error))load()/AsyncImage 背后创建的都是同一个东西ImageRequest交给全局单例 ImageLoader 执行。三、核心组件角色分工组件职责类比ImageLoader入口与配置中心缓存、组件注册表、默认 OkHttp全局单例类似 OkHttpClientImageRequest一次加载的完整描述data、size、placeholder、transformations、target、listener、缓存策略类似 RequestImageResult结果密封类Successdrawable 元数据/ Errordrawable throwable类似 ResponseMapper数据类型映射把自定义类型转成 Fetcher 认识的类型如 String → HttpUri—Fetcher数据源获取网络OkHttp、文件、ContentProvider Uri、资源、Drawable、字节数组类似 ConnectCallServerDecoder解码成 BitmapBitmapFactoryDecoder、GIFAnimatedImageDecoder、SVG、视频帧类似 ConverterTransformation解码后变换圆角/圆形/模糊—MemoryCache / DiskCache内存 LruCache / 磁盘缓存类似 CacheInterceptorInterceptorCoil 自己的责任链拦截器可插拔自定义逻辑直接借鉴 OkHttpTarget结果投递目标ImageView、Compose Painter、自定义 View—SizeResolver延迟解析目标尺寸等 View 布局完成/Painter 测量后拿到真实像素宽高—四、完整工作流程一次 load() 的旅程imageView.load(url) / AsyncImage(model) │ ▼ ① 构建 ImageRequest含 lifecycle、sizeResolver、缓存策略、target │ ▼ ② ImageLoader.enqueue(request)或 suspend 版 execute() │ → 进入 RealImageLoader构建 RealInterceptorChain │ → 核心引擎EngineInterceptor 你注册的自定义 Interceptor ▼ ③ 计算内存缓存 key key data size scale transformations parameters decoder配置 │ ├─ MemoryCache 命中→ 直接返回 Bitmap → 跳转到 ⑧ 显示 │ 注意不同尺寸/不同 transformation 是不同 key同 URL 也可能多份缓存 │ ▼ 未命中 ④ 解析尺寸 SizeResolver.size() 若 View 尚未布局完成 → 挂起协程等待 onLayout 拿到真实像素宽高 为什么图片会按控件大小精确采样——尺寸在请求时就确定了 │ ▼ ⑤ 磁盘缓存按 key 查 DiskCache默认 image_cache 目录 ├─ 命中 → 读出数据 → ⑦ 解码 └─ 未命中 → ⑥ ▼ ⑥ Fetcher 获取原始数据 HttpUriFetcher → 用内置 OkHttp Call.Factory 下载可注入你的 OkHttpClient 复用它的连接池/拦截器/缓存——Coil 自己不实现网络层 FileFetcher / ResourceFetcher / ContentUriFetcher ... → 拿到 BufferedSource同时写入磁盘缓存 │ ▼ ⑦ Decoder.decode() 按目标 size 计算 inSampleSize 采样 → BitmapFactory 解码 → 从 BitmapPool 找可复用 Bitmap 填充像素inBitmap省内存防抖动 → 应用 Transformations圆形/圆角 → 写入内存缓存 │ ▼ ⑧ 结果投递 Target Success → CrossfadeTransition 淡入显示到 ImageView/Painter Error → 显示 error 占位图 全程通过 Listener 回调onStart/onSuccess/onError可做埋点两条隐藏主线贯穿全程协程整个加载等待布局、下载、解码、变换都跑在 Dispatchers.IOexecute() 是 suspend 函数解码本身 CPU 密集Coil 会按 CPU 核数限制并发解码数生命周期请求与 LifecycleOwner 绑定——页面销毁/View detach 自动取消请求下载中断、协程取消天然防内存泄漏不需要 Glide 那种 with(fragment) 手动绑定五、缓存机制详解层级实现默认策略内存缓存MemoryCacheLruCache 强引用默认大小 应用可用内存的 25%key 由 datasize变换参数综合生成磁盘缓存DiskCacheOkio 文件系统 journal 日志DiskLruCache 思想默认目录cacheDir/image_cache默认上限约250MB按磁盘空间比例动态计算BitmapPoolRealBitmapPool解码时inBitmap复用已回收 Bitmap 的像素内存避免反复分配触发 GC 抖动缓存 key 的细节Coil 的缓存 key不只是 URL而是 URL 目标尺寸 Scale Transformations 自定义参数的组合。所以同一张图在 100dp 头像和全屏详情页里是两份独立缓存——这不是浪费恰恰保证了每个位置拿到的都是按自身尺寸精确采样过的最优 Bitmap。可配置ImageRequest 上可单独控制 memoryCachePolicy / diskCachePolicy / networkCachePolicy比如头像强制走缓存、验证码强制走网络。六、与 Glide 对比维度CoilGlide语言/并发模型纯 Kotlin协程Java 为主线程池 回调体积~1.5MB方法数少较大API 风格DSL、ImageRequest.Builder扩展函数with().load().into() 注解生成 APIGlideAppCompose 支持原生一等公民AsyncImage 官方出品通过 Landscapist 等三方封装非原生缓存层级内存 LruCache 磁盘 BitmapPool活动资源弱引用 内存 磁盘 BitmapPool多一层活跃缓存生命周期协程 Lifecycle 自动取消RequestManager 与 Fragment/Activity 绑定网络层复用 OkHttp可注入自定义 client默认 HttpUrlConnection可换 OkHttp 集成库扩展机制Mapper/Fetcher/Decoder/Interceptor 注册表协程友好ModelLoader/ResourceDecoder/AppGlideModuleKMPCoil 3 支持 Kotlin Multiplatform不支持选型结论新项目 Compose 用 Coil存量大项目 Glide 不必强迁。七、实战配置// 全局自定义 ImageLoaderApplication 实现 SingletonImageLoader.FactoryclassApp:Application(),SingletonImageLoader.Factory{overridefunnewImageLoader(context:Context):ImageLoader{returnImageLoader.Builder(context).memoryCache{MemoryCache.Builder(context).maxSizePercent(0.25)// 内存缓存占比.build()}.diskCache{DiskCache.Builder().directory(context.cacheDir.resolve(image_cache)).maxSizeBytes(256*1024*1024).build()}.components{// 注入你自己的 OkHttpClient复用连接池、Token 拦截器、日志add(OkHttpNetworkFetcherFactory(callFactorymyOkHttpClient))// 自定义 Fetcher比如私有协议头、加密图床、鉴权下载add(CustomSchemeFetcher.Factory())add(SvgDecoder.Factory())// SVG 支持add(VideoFrameDecoder.Factory())// 视频帧}.crossfade(true).respectCacheHeaders(false)// 忽略服务器缓存头客户端说了算.build()}}Compose 场景补充// 需要定制 loading/error 槽位时用 SubcomposeAsyncImageSubcomposeAsyncImage(modelurl,contentDescriptionnull,loading{CircularProgressIndicator()},error{Icon(Icons.Default.Warning,null)})八、常见问题Coil 是什么—— Coroutine Image Loader纯 Kotlin 协程图片库轻量、Compose 官方搭档。缓存机制—— 内存 LruCache默认 25% 可用内存 磁盘缓存默认约 250MB BitmapPool 像素复用key URL 尺寸 变换 参数的组合不是纯 URL。为什么图片不会 OOM—— 请求时通过 SizeResolver 拿到目标 View 的真实像素尺寸解码时按 inSampleSize 精确采样 BitmapPool 复用。生命周期怎么处理—— 请求绑定 LifecycleOwner协程自动取消天然防泄漏。和 Glide 的区别—— 按上面表格答重点协程 vs 线程池、体积、Compose 原生支持、缓存层级差异。网络层谁做的—— Coil 自己不实现网络默认/可注入 OkHttp 的 Call.Factory连接池和拦截器全部复用——这也是为什么 Coil 能做到这么小。如何加载需要鉴权/加密的图片—— 注入带 Token 拦截器的 OkHttpClient更复杂的自定义协议就实现自定义 Fetcher 注册进 components。Transformer 在哪一步执行—— 解码之后、写入内存缓存之前且 transformation 参与缓存 key变换结果本身被缓存不重复执行。九、总结Coil 是基于 Kotlin 协程的图片加载库load()/AsyncImage 构建 ImageRequest 交给 ImageLoader内部走一条借鉴 OkHttp 的拦截器责任链先按URL尺寸变换生成的 key 查内存 LruCache未命中则等 SizeResolver 解析出目标像素尺寸后查磁盘缓存再未命中由 Fetcher默认复用 OkHttp拉取数据Decoder 按目标尺寸采样解码并用 BitmapPool 复用像素内存应用 Transformation 后写内存缓存最后 Crossfade 淡入显示。全程跑在 IO 调度器生命周期绑定协程自动取消。它轻量的原因是只做加载流水线——网络复用 OkHttp、缓存复用 LruCache/DiskLruCache 思想自己绝不多造轮子。