前言文件拷贝和移动是文件管理的常见操作如备份文件、整理目录结构等。pura/harmony-utils的FileUtil封装了文件拷贝和移动方法支持跨目录操作。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、FileUtil拷贝移动核心APIFileUtil提供了以下文件拷贝和移动方法方法说明返回类型使用场景copyFile(src, dest)拷贝文件void文件备份copyDir(src, dest)拷贝目录void目录备份moveFile(src, dest)移动文件void文件归档moveDir(src, dest)移动目录void目录整理1.1 核心特性简洁易用封装复杂API为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃跨目录支持支持跨目录的拷贝和移动操作1.2 拷贝与移动区别操作源文件目标文件适用场景拷贝保留新增副本备份、复制移动删除新增归档、整理二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 文件拷贝import{FileUtil}frompura/harmony-utils;Button(拷贝文件).width(100%).onClick((){try{letsrcFileUtil.getFilesDir()/test.txt;letdestFileUtil.getFilesDir()/backup.txt;FileUtil.copyFile(src,dest);this.result拷贝成功 ✅\n源: test.txt\n目标: backup.txt;}catch(e){this.result异常: e;}})2.3 文件移动Button(移动文件).width(100%).onClick((){try{letsrcFileUtil.getFilesDir()/backup.txt;letdestFileUtil.getFilesDir()/archive/backup.txt;FileUtil.moveFile(src,dest);this.result移动成功 ✅\n已移至archive目录;}catch(e){this.result异常: e;}})三、完整页面示例import{FileUtil}frompura/harmony-utils;EntryComponentstruct FileCopyDemo{Stateresult:string;build(){Column({space:12}){Button(创建测试文件).width(100%).onClick((){FileUtil.writeTextSync(FileUtil.getFilesDir()/src.txt,测试内容);this.result测试文件已创建;});Button(拷贝文件).width(100%).onClick((){try{FileUtil.copyFile(FileUtil.getFilesDir()/src.txt,FileUtil.getFilesDir()/dst.txt);this.result拷贝成功;}catch(e){this.result异常: e;}});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 文件备份策略import{FileUtil}frompura/harmony-utils;functionbackupFile(filePath:string):string{letbackupPathfilePath.bak;FileUtil.copyFile(filePath,backupPath);returnbackupPath;}4.2 批量移动文件functionmoveFilesToArchive(filePaths:string[]):void{letarchiveDirFileUtil.getFilesDir()/archive;FileUtil.createDir(archiveDir);filePaths.forEach(path{letfilenamepath.split(/).pop()||;FileUtil.moveFile(path,archiveDir/filename);});}五、注意事项目标路径目标路径的父目录必须存在同名文件目标路径已存在同名文件会覆盖跨分区移动操作跨分区时实际为拷贝删除初始化依赖使用前需确保AppUtil.init()已调用大文件大文件拷贝可能耗时建议异步处理六、常见问题Q1: 拷贝文件时目标目录不存在需要先创建目标目录使用createDir()创建后再拷贝。Q2: 移动文件后源文件还在可能是跨分区移动失败检查源路径和目标路径是否有效。Q3: 如何批量拷贝整个目录使用copyDir()方法可以拷贝整个目录及其内容。Q4: 拷贝过程中断会导致数据丢失吗拷贝是原子操作中断后目标文件可能不完整建议校验后使用。总结FileUtil的文件拷贝和移动方法为文件管理提供了便捷操作。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以根据需求选择拷贝或移动操作。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。