鸿蒙三方库 | harmony-utils之FileUtil文件创建与删除详解

前言文件创建和删除是文件管理的基本操作。pura/harmony-utils的FileUtil封装了文件和目录的创建、删除方法支持递归创建目录和强制删除非空目录。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、FileUtil创建删除核心APIFileUtil提供了以下文件创建和删除方法方法说明返回类型使用场景createFile(path)创建文件void新建空文件createDir(path)创建目录void新建目录deleteFile(path)删除文件void清理文件deleteDir(path)删除目录void清理目录exists(path)判断文件是否存在boolean存在性检查1.1 核心特性简洁易用封装复杂API为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃递归支持支持递归创建多级目录1.2 创建删除操作对照操作方法前提条件异常情况创建文件createFile父目录存在文件已存在创建目录createDir父目录存在目录已存在删除文件deleteFile文件存在文件不存在删除目录deleteDir目录存在目录不存在二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 创建文件和目录import{FileUtil}frompura/harmony-utils;Button(创建目录).width(100%).onClick((){try{letdirPathFileUtil.getFilesDir()/mydir;FileUtil.createDir(dirPath);this.result目录创建成功 ✅\n${dirPath};}catch(e){this.result异常: e;}})Button(创建文件).width(100%).onClick((){try{letfilePathFileUtil.getFilesDir()/mydir/test.txt;FileUtil.createFile(filePath);this.result文件创建成功 ✅\n${filePath};}catch(e){this.result异常: e;}})2.3 删除文件和目录Button(删除文件).width(100%).onClick((){try{letfilePathFileUtil.getFilesDir()/mydir/test.txt;FileUtil.deleteFile(filePath);this.result文件删除成功 ️;}catch(e){this.result异常: e;}})Button(删除目录).width(100%).onClick((){try{letdirPathFileUtil.getFilesDir()/mydir;FileUtil.deleteDir(dirPath);this.result目录删除成功 ️;}catch(e){this.result异常: e;}})三、完整页面示例import{FileUtil}frompura/harmony-utils;EntryComponentstruct FileCreateDemo{Stateresult:string;build(){Column({space:12}){Button(创建并删除文件).width(100%).onClick((){try{letpathFileUtil.getFilesDir()/temp.txt;FileUtil.createFile(path);letexistsFileUtil.exists(path);FileUtil.deleteFile(path);this.result创建: 成功\n存在:${exists}\n删除: 成功;}catch(e){this.result异常: e;}});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 安全创建文件import{FileUtil}frompura/harmony-utils;functionsafeCreateFile(path:string):boolean{try{if(!FileUtil.exists(path)){FileUtil.createFile(path);}returntrue;}catch(e){returnfalse;}}4.2 安全删除文件functionsafeDelete(path:string):boolean{try{if(FileUtil.exists(path)){if(FileUtil.isDirectory(path)){FileUtil.deleteDir(path);}else{FileUtil.deleteFile(path);}}returntrue;}catch(e){returnfalse;}}五、注意事项父目录创建文件前需确保父目录存在删除不可逆文件删除后无法恢复建议确认后再删除非空目录删除非空目录可能需要递归删除初始化依赖使用前需确保AppUtil.init()已调用并发安全多线程操作同一文件需注意并发安全六、常见问题Q1: 创建文件时提示父目录不存在需要先创建父目录使用createDir()创建父目录后再创建文件。Q2: 删除目录时提示目录非空需要先删除目录中的所有文件和子目录或使用递归删除方法。Q3: exists()返回true但无法读取可能是权限不足检查文件权限配置。Q4: 创建文件后立即读取为空新创建的文件内容为空需要先写入内容再读取。总结FileUtil的文件创建和删除方法为文件管理提供了基础操作支持。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。合理使用创建和删除操作可以高效管理应用文件。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。