当前位置：首页 > news >正文

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

news 2026/7/19 0:54:19

前言

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

一、FileUtil创建删除核心API

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

方法	说明	返回类型	使用场景
`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 安装依赖

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;}}