【走进鸿蒙002】文件操作案例:创建、写入和读取文件

以下案例基于华为鸿蒙官方文档,展示如何通过ohos.file.fs模块实现文件的基本操作。代码使用TypeScript(ArkUI开发框架),适用于HarmonyOS应用开发。

一、创建并写入文件

typescript 复制代码
import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common';

// 获取应用沙箱路径
let context = getContext(this) as common.UIAbilityContext;
let sandboxPath = context.filesDir;

// 文件路径
let filePath = sandboxPath + '/test.txt';

try {
  // 创建文件并写入内容
  let file = fs.openSync(filePath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
  fs.writeSync(file.fd, "Hello HarmonyOS");
  fs.closeSync(file.fd);
  console.log('文件写入成功');
} catch (err) {
  console.error(`操作失败: ${err.code}, ${err.message}`);
}

代码解读:

  • fs.openSync()使用CREATE和READ_WRITE标志创建可读写文件
  • fs.writeSync()同步写入字符串内容
  • 必须调用fs.closeSync()释放文件描述符

二、读取文件内容

typescript 复制代码
import fs from '@ohos.file.fs';

try {
  let file = fs.openSync(filePath, fs.OpenMode.READ_ONLY);
  let stat = fs.statSync(filePath);

  let buffer = new ArrayBuffer(stat.size);
  fs.readSync(file.fd, buffer);
  let textDecoder = new util.TextDecoder();
  let content = textDecoder.decode(buffer);
  console.log('文件内容: ' + content);

  fs.closeSync(file.fd);
} catch (err) {
  console.error(`读取失败: ${err.code}, ${err.message}`);
}

代码解读:

  • fs.statSync()获取文件大小信息
  • ArrayBuffer准备接收数据的缓冲区
  • TextDecoder将二进制数据转为字符串
运行效果展示
plaintext 复制代码
[控制台输出]
文件写入成功
文件内容: Hello HarmonyOS

三、 复制文件

typescript 复制代码
let destPath = sandboxPath + '/test_backup.txt';

try {
  fs.copyFileSync(filePath, destPath);
  console.log('文件复制成功');
} catch (err) {
  console.error(`复制失败: ${err.code}, ${err.message}`);
}

四、删除文件

typescript 复制代码
try {
  fs.unlinkSync(destPath);
  console.log('文件删除成功');
} catch (err) {
  console.error(`删除失败: ${err.code}, ${err.message}`);
}

关键API说明:

  • copyFileSync(): 同步复制文件
  • unlinkSync(): 同步删除文件
  • 所有同步方法均有对应的异步版本(如copyFile())

文件管理注意事项

  1. 权限声明:需在module.json5中添加文件访问权限
json 复制代码
"requestPermissions": [
  {
    "name": "ohos.permission.FILE_ACCESS_MANAGER"
  }
]
  1. 沙箱限制:应用默认只能访问自身沙箱目录
  2. 大文件处理:建议使用流式读写(createStream()/read())避免内存溢出

完整示例项目结构

复制代码
entry/src/main/
  ├── ets/
  │   ├── pages/
  │   │   └── Index.ets  # 主页面
  ├── resources/         # 静态资源
  └── module.json5       # 权限配置
相关推荐
码间留白17 小时前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
jianqiang.xue1 天前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
todoitbo7 天前
把 K-Lite「什么都能播」搬上鸿蒙 PC:影匣播放器的 FFmpeg + libass 原生移植实录
华为·ffmpeg·harmonyos·鸿蒙
c2892480843s7 天前
【鸿蒙心迹】深色模式适配实战:资源限定词、动态取色与一张图两个主题
移动开发·harmonyos·鸿蒙·arkui·深色模式
码间留白8 天前
六轮真机实验后,我把鸿蒙直播推流的 UI 全逼成了原生——uni-app 适配 HarmonyOS NEXT 完整复盘
uni-app·鸿蒙·harmonyos next·直播推流·arkts/arkui
c2892480843s9 天前
【鸿蒙心迹】网络请求封装实战:RCP 选型、拦截器与弱网预算
移动开发·网络请求·harmonyos·鸿蒙·rcp
码间留白14 天前
uni-app 鸿蒙离线打包:一个改动从源码到真机要穿过几条链
uni-app·鸿蒙·deveco·离线打包·uts插件
码间留白15 天前
鸿蒙端对接 BLE 血压计:从一次握手到读数入库(二)设备篇
物联网·uni-app·鸿蒙·蓝牙ble·血压计
行者-全栈开发15 天前
【共创稿事节】HarmonyOS 应用上架全流程中的隐私合规:权限最小化、数据本地化与 AppAnalyzer 体检
harmonyos·鸿蒙·隐私合规·应用上架·agc·appanalyzer
熊猫钓鱼>_>16 天前
三方库 NDK 原生模块跨平台适配与调试【鸿蒙心迹】
开发语言·华为·ai编程·harmonyos·鸿蒙·openharmony·鸿蒙心迹