前言

文件创建和删除是文件管理的基本操作。@pura/harmony-utils的FileUtil封装了文件和目录的创建、删除方法，支持递归创建目录和强制删除非空目录。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解，帮助开发者快速掌握并应用到实际项目中。

一、FileUtil创建删除核心API

FileUtil提供了以下文件创建和删除方法：

1.1 核心特性

• 简洁易用：封装复杂API为一行调用，降低使用门槛
• 类型安全：完整的TypeScript类型定义，编译期即可发现错误
• 异常处理：内置异常捕获机制，避免运行时崩溃
• 递归支持：支持递归创建多级目录

1.2 创建删除操作对照

二、完整使用步骤

2.1 安装依赖

ohpminstall@pura/harmony-utils

2.2 创建文件和目录

import{FileUtil}from'@pura/harmony-utils';Button('创建目录').width('100%').onClick(()=>{try{letdirPath=FileUtil.getFilesDir()+'/mydir';FileUtil.createDir(dirPath);this.result=`目录创建成功 ✅\n${dirPath}`;}catch(e){this.result='异常: '+e;}})Button('创建文件').width('100%').onClick(()=>{try{letfilePath=FileUtil.getFilesDir()+'/mydir/test.txt';FileUtil.createFile(filePath);this.result=`文件创建成功 ✅\n${filePath}`;}catch(e){this.result='异常: '+e;}})

2.3 删除文件和目录

Button('删除文件').width('100%').onClick(()=>{try{letfilePath=FileUtil.getFilesDir()+'/mydir/test.txt';FileUtil.deleteFile(filePath);this.result='文件删除成功 🗑️';}catch(e){this.result='异常: '+e;}})Button('删除目录').width('100%').onClick(()=>{try{letdirPath=FileUtil.getFilesDir()+'/mydir';FileUtil.deleteDir(dirPath);this.result='目录删除成功 🗑️';}catch(e){this.result='异常: '+e;}})

三、完整页面示例

import{FileUtil}from'@pura/harmony-utils';@Entry@Componentstruct FileCreateDemo{@Stateresult:string='';build(){Column({space:12}){Button('创建并删除文件').width('100%').onClick(()=>{try{letpath=FileUtil.getFilesDir()+'/temp.txt';FileUtil.createFile(path);letexists=FileUtil.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}from'@pura/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;}}

五、注意事项

1. 父目录：创建文件前需确保父目录存在
2. 删除不可逆：文件删除后无法恢复，建议确认后再删除
3. 非空目录：删除非空目录可能需要递归删除
4. 初始化依赖：使用前需确保AppUtil.init()已调用
5. 并发安全：多线程操作同一文件需注意并发安全

六、常见问题

Q1: 创建文件时提示父目录不存在？

需要先创建父目录，使用createDir()创建父目录后再创建文件。

Q2: 删除目录时提示目录非空？

需要先删除目录中的所有文件和子目录，或使用递归删除方法。

Q3: exists()返回true但无法读取？

可能是权限不足，检查文件权限配置。

Q4: 创建文件后立即读取为空？

新创建的文件内容为空，需要先写入内容再读取。

总结

FileUtil的文件创建和删除方法为文件管理提供了基础操作支持。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。合理使用创建和删除操作，可以高效管理应用文件。

本文基于@pura/harmony-utils工具库，更多功能请参考官方文档与后续系列文章。