蒙三方库 | harmony-utils之FileUtil文件重命名与属性查询详解

前言文件重命名和属性查询是文件管理的重要操作。pura/harmony-utils的FileUtil封装了文件重命名和属性查询方法开发者可以轻松获取文件大小、修改时间等属性。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、FileUtil属性核心APIFileUtil提供了以下文件属性查询方法方法说明返回类型使用场景rename(oldPath, newPath)重命名文件void文件整理getFileInfo(path)获取文件属性FileInfo属性查看getFileSize(path)获取文件大小number大小展示isDirectory(path)是否目录boolean类型判断isFile(path)是否文件boolean类型判断1.1 核心特性简洁易用封装复杂API为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃属性全面覆盖文件大小、类型等常用属性1.2 文件属性信息对照属性获取方法说明示例值文件大小getFileSize字节数1024是否文件isFile布尔值true是否目录isDirectory布尔值false文件信息getFileInfoFileInfo对象-二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 文件重命名import{FileUtil}frompura/harmony-utils;Button(重命名文件).width(100%).onClick((){try{letoldPathFileUtil.getFilesDir()/old.txt;letnewPathFileUtil.getFilesDir()/new.txt;FileUtil.rename(oldPath,newPath);this.result重命名成功 ✅\nold.txt → new.txt;}catch(e){this.result异常: e;}})2.3 查询文件属性Button(查询文件属性).width(100%).onClick((){try{letpathFileUtil.getFilesDir()/test.txt;letisFileFileUtil.isFile(path);letsizeFileUtil.getFileSize(path);this.result是文件:${isFile}\n大小:${size}字节;}catch(e){this.result异常: e;}})三、完整页面示例import{FileUtil}frompura/harmony-utils;EntryComponentstruct FileAttrDemo{Stateresult:string;build(){Column({space:12}){Button(查询属性).width(100%).onClick((){try{letpathFileUtil.getFilesDir()/test.txt;letexistsFileUtil.exists(path);letisFileFileUtil.isFile(path);this.result存在:${exists}\n是文件:${isFile};}catch(e){this.result异常: e;}});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 文件信息展示import{FileUtil}frompura/harmony-utils;functiongetFileDetail(path:string):Recordstring,Object{return{path:path,exists:FileUtil.exists(path),isFile:FileUtil.isFile(path),isDir:FileUtil.isDirectory(path),size:FileUtil.formatFileSize(FileUtil.getFileSize(path))};}4.2 批量重命名functionbatchRename(dir:string,prefix:string):void{letfilesFileUtil.listFile(dir);files.forEach((file,index){letextfile.split(.).pop()||;FileUtil.rename(dir/file,dir/prefix_index.ext);});}五、注意事项重命名路径新旧路径必须在同一文件系统文件存在查询属性前建议先检查文件是否存在大小精度文件大小以字节为单位初始化依赖使用前需确保AppUtil.init()已调用并发安全重命名操作期间不要同时读写该文件六、常见问题Q1: 重命名时提示跨文件系统源路径和目标路径必须在同一分区不能跨分区重命名。Q2: getFileSize()返回0可能是空文件或目录目录的大小通常为0。Q3: isFile()和isDirectory()都返回false可能是文件不存在先用exists()检查。Q4: 重命名后原路径文件还在吗重命名成功后原路径文件不存在已移动到新路径。总结FileUtil的文件属性查询和重命名方法为文件管理提供了重要支持。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以利用这些方法实现文件信息展示和批量操作。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。