鸿蒙三方库 | harmony-utils之FileUtil文件管理与目录详解

前言文件管理包括文件创建、删除、复制、移动以及目录操作等。pura/harmony-utils的FileUtil封装了文件管理和目录操作方法简化了文件系统操作。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、FileUtil管理核心APIFileUtil提供了以下文件管理方法方法说明返回类型使用场景exists(path)文件是否存在boolean存在检查isFile(path)是否文件boolean类型判断isDirectory(path)是否目录boolean类型判断createFile(path)创建文件void文件创建createDirectory(path)创建目录void目录创建delete(path)删除文件或目录void文件清理rename(path, newName)重命名void文件重命名copy(src, dest)复制文件void文件备份move(src, dest)移动文件void文件整理getFilesDir()获取应用文件目录string路径获取getCacheDir()获取缓存目录string缓存路径listFiles(path)列出目录文件string[]文件浏览1.1 核心特性简洁易用封装复杂逻辑为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃全面覆盖覆盖文件和目录的增删改查操作1.2 目录类型对照目录方法说明生命周期文件目录getFilesDir应用私有文件随应用缓存目录getCacheDir临时缓存系统可清理临时目录getTempDir临时文件随时清理二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 文件存在判断import{FileUtil}frompura/harmony-utils;Button(文件存在判断).width(100%).onClick((){try{letpathFileUtil.getFilesDir()/test.txt;letexistsFileUtil.exists(path);this.result${path}\n存在:${exists?是 ✅:否 ❌};}catch(e){this.result异常: e;}})2.3 创建与删除Button(创建与删除).width(100%).onClick((){try{letdirFileUtil.getFilesDir()/mydir;FileUtil.createDirectory(dir);FileUtil.createFile(dir/note.txt);this.result目录和文件已创建 ✅;}catch(e){this.result异常: e;}})三、完整页面示例import{FileUtil}frompura/harmony-utils;EntryComponentstruct FileManageDemo{Stateresult:string;build(){Column({space:12}){Button(文件目录).width(100%).onClick((){this.result文件:${FileUtil.getFilesDir()}\n缓存:${FileUtil.getCacheDir()};});Button(创建目录).width(100%).onClick((){FileUtil.createDirectory(FileUtil.getFilesDir()/demo);this.result目录已创建;});Button(列出文件).width(100%).onClick((){letfilesFileUtil.listFiles(FileUtil.getFilesDir());this.result文件数:${files.length};});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 缓存管理import{FileUtil}frompura/harmony-utils;functionclearCache():void{letcacheDirFileUtil.getCacheDir();letfilesFileUtil.listFiles(cacheDir);files.forEach(file{FileUtil.delete(file);});}4.2 文件备份functionbackupFile(srcPath:string):string{letbackupDirFileUtil.getFilesDir()/backup;FileUtil.createDirectory(backupDir);letfileNamesrcPath.split(/).pop();letdestPathbackupDir/fileName;FileUtil.copy(srcPath,destPath);returndestPath;}五、注意事项路径安全使用FileUtil提供的方法获取安全路径删除不可逆delete操作不可恢复谨慎使用目录递归delete删除目录时可能递归删除所有内容初始化依赖使用前需确保AppUtil.init()已调用并发安全多线程同时操作同一文件需注意并发安全六、常见问题Q1: delete删除目录会删除子文件吗通常会的delete删除目录时会递归删除所有子文件和子目录。Q2: copy可以复制目录吗取决于实现部分只支持文件复制目录需递归处理。Q3: getFilesDir返回的路径应用卸载后还在吗不在了应用私有目录随应用卸载而被清除。Q4: 如何获取外部存储路径HarmonyOS使用沙箱机制应用只能访问自己的目录。总结FileUtil的文件管理和目录方法为文件系统操作提供了便捷支持。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以利用这些方法实现文件管理、缓存清理等功能。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。