Flutter 缓存管理库 flutter_cache_manager 的核心功能与使用方法。该库支持下载和缓存应用目录中的文件，利用 Cache-Control 和 ETag 头部高效管理文件生命周期。内容涵盖基础文件获取、图片缓存、自定义配置（包括过期时间、数量限制、存储仓库）、常见问题解答以及 v2 版本的破坏性变更说明。文章强调了 Key 唯一性的重要性，并提供了关于存储位置、更新机制及删除策略的详细解释，同时给出了针对敏感数据和内存管理的最佳实践建议。
flutter_cache_manager 是 Flutter 应用中用于下载和管理文件缓存的常用库。它支持将文件存储在应用的缓存目录中，并通过配置控制缓存的有效期和数量。该库利用 HTTP 的 Cache-Control 头部来高效地提取和验证文件。
CacheManager 提供了多种方式来获取文件，开发者可以根据具体场景选择合适的方法。
getSingleFile。
var file = await DefaultCacheManager().getSingleFile(url);
getFileStream 返回一个流，第一个结果是已缓存的文件（如果有），后续结果包含正在下载的文件。
// 仅获取缓存或开始下载
Stream<FileResponse> stream = cacheManager.getFileStream(url);
// 带进度回调，当缓存未命中时触发下载进程
Stream<FileResponse> streamWithProgress = cacheManager.getFileStream(url, withProgress: true);
downloadFile 直接从网络下载文件，不优先检查缓存。getFileFromCache 只尝试从本地缓存提取。如果缓存中没有文件，则返回空值（no file）。putFile 允许向缓存中添加一个新文件，无需经过网络下载流程。removeFile：移除指定的单个文件。emptyCache：清空所有缓存文件。对于图片资源，可以使用 ImageCacheManager Mixin（DefaultCacheManager 默认已集成）。它提供了 getImageFile 方法，支持在缓存前对图像进行尺寸调整。
Stream<FileResponse> getImageFile(String url, {
String key,
Map<String, String> headers,
bool withProgress,
int maxHeight, // 目标最大高度
int maxWidth, // 目标最大宽度
})
可以通过创建新的 CacheManager 实例来实现更精细的管理。注意：不要使用相同的 key 创建多个 CacheManager 实例，否则会导致缓存冲突。
通常建议将管理器作为单例创建，或者通过 Provider 等状态管理方案在应用顶层提供。
构造方法的 key 参数是强制性的，其他变量均为可选。以下是一个完整的自定义配置示例：
class CustomCacheManager {
static const key = 'customCacheKey';
static CacheManager instance = CacheManager(
Config(
key,
// 缓存过期时间：7 天后视为过期
stalePeriod: const Duration(days: 7),
// 缓存对象最大数量：最多保留 20 个文件
maxNrOfCacheObjects: 20,
// 元数据存储仓库：使用 SQLite 数据库存储缓存信息
repo: JsonCacheInfoRepository(databaseName: key),
// 文件系统实现：IOFileSystem 表示使用本地文件系统
fileSystem: IOFileSystem(key),
// 文件服务：HttpFileService 负责网络请求
fileService: HttpFileService(),
),
);
}
sqflite)，其他平台使用 JSON 文件。默认情况下，缓存的文件存储在应用的缓存目录中。这意味着操作系统可能会在存储空间不足时随时删除这些文件。
CacheManager 的 key 一致。文件更新机制依赖于 HTTP 响应头：
更新逻辑：
getSingleFile 或 getFileStream 时，首先检查缓存。文件可能因以下原因被删除：
CacheManager 根据两个变量主动删除文件：
maxNrOfCacheObjects：超过最大数量限制。stalePeriod：超过过期时间且未被使用。当需要清空缓存时，管理器会按最后使用时间排序，优先删除那些超过过期时间很久且使用频率低的文件。
升级到 v2 版本时，请注意以下主要变化：
BaseCacheManager，可以直接调用 CacheManager 的构造函数。BaseCacheManager 现在仅作为一个接口存在。Config），而非直接传递参数。这提供了更大的灵活性，例如可以自定义存储文件的文件系统，而不仅仅是目录。CacheManager 实例都有唯一的 key，防止元数据冲突。maxNrOfCacheObjects 和 stalePeriod，避免占用过多磁盘空间。getFileStream 时，建议监听流的错误事件，以便在网络不可用时提供降级体验。ImageCacheManager 时，合理设置 maxHeight 和 maxWidth，避免缓存过大的原始图片导致内存浪费。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online