前言

fileIo 是 HarmonyOS 的文件 I/O 模块，支持文件的打开、读写、删除等操作。在「猫猫大作战」中，fileIo 用于保存游戏截图文件、读取配置文件。

一、文件读写

import { fileIo } from '@kit.CoreFileKit';

async function writeTextFile(path: string, content: string): Promise<void> {
  const file = fileIo.openSync(path,
    fileIo.OpenMode.CREATE | fileIo.OpenMode.WRITE_ONLY | fileIo.OpenMode.TRUNC);
  const encoder = new TextEncoder();
  fileIo.writeSync(file.fd, encoder.encode(content));
  fileIo.closeSync(file);
}

async function readTextFile(path: string): Promise<string> {
  const file = fileIo.openSync(path, fileIo.OpenMode.READ_ONLY);
  const stat = fileIo.statSync(path);
  const buf = new ArrayBuffer(stat.size);
  fileIo.readSync(file.fd, buf);
  fileIo.closeSync(file);
  return new TextDecoder().decode(buf);
}

二、文件操作方法

三、文件打开模式

四、游戏中的应用

// 保存游戏截图
async function saveScreenshot(pixelMap: PixelMap, path: string): Promise<void> {
  const packer = image.createImagePacker();
  const buffer = await packer.packing(pixelMap, {
    format: 'image/jpeg', quality: 85,
  });
  packer.release();

  const file = fileIo.openSync(path,
    fileIo.OpenMode.CREATE | fileIo.OpenMode.WRITE_ONLY | fileIo.OpenMode.TRUNC);
  fileIo.writeSync(file.fd, buffer);
  fileIo.closeSync(file);
}

五、最佳实践

1. 用完关闭 FD：closeSync(fd) 释放资源
2. try-finally 保证关闭：异常时也要 close
3. 路径使用沙箱目录：filesDir、cacheDir
4. 大文件分块读写：单次读写不超 1MB

总结

fileIo 提供文件打开、读写、删除等基础操作。核心要点：openSync 打开、 readSync/writeSync 读写、 closeSync 关闭释放、 沙箱路径安全操作。

如果这篇文章对你有帮助，欢迎点赞👍、收藏⭐、关注🔔，你的支持是我持续创作的动力！

相关资源：

• fileIo API 参考
• 第 140 篇：AppStorage
• 第 142 篇：sandbox-path
• 第 143 篇：JSON