第二三课：HarmonyOS Next文件操作开发指南：读写与管理实战

一、文件读写核心接口

1. 基础文件操作

HarmonyOS Next通过@kit.CoreFileKit模块提供完整的文件操作接口，支持文本与二进制文件的读写操作‌ 代码示例：文本文件读写

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

// 写入文件
const writeFile = async (path: string, content: string) => {
const fd = await File.open(path, File.MODE_WRITE | File.MODE_CREATE);
await File.write(fd, buffer.fromString(content));
File.close(fd);
};

// 读取文件
const readFile = async (path: string) => {
const fd = await File.open(path, File.MODE_READ);
const buf = await File.read(fd, { length: 1024 });
File.close(fd);
return buffer.toString(buf);
};

2. 二进制文件处理

针对媒体文件等二进制数据，采用流式读写提升性能‌

// 分块读取大文件
const readLargeFile = async (path: string) => {
const fd = await File.open(path, File.MODE_READ);
let offset = 0;
const chunkSize = 4096;
while (true) {
const { bytesRead } = await File.read(fd, { offset, length: chunkSize });
if (bytesRead === 0) break;
offset += bytesRead;
}
File.close(fd);
};

二、文件系统管理

1. 目录操作

通过directoryIo模块实现目录创建、遍历等操作‌

import { directoryIo } from '@kit.CoreFileKit';
// 创建嵌套目录
directoryIo.createDir('/data/storage/files/documents', 0o775);

// 遍历目录内容
const listFiles = async (dirPath: string) => {
const dir = await directoryIo.opendir(dirPath);
let entry;
while ((entry = await dir.read()) !== undefined) {
console.log(entry.name);
}
dir.close();
};

2. 文件查询与元数据

结合mediatool命令行工具实现高效文件定位‌

查询媒体文件位置

hdc shell mediatool query IMG_20240902_204224.jpg

3. 安全文件访问

通过系统Picker实现安全的文件选择与保存‌

// 使用文件选择器保存文件
const saveWithPicker = async (content: string) => {
const picker = new picker.DocumentViewPicker();
const result = await picker.save({ newFileNames: ['report.txt'] });
await File.write(result, buffer.fromString(content));
};

三、最佳实践与性能优化

1. 关键性能指标对比

操作类型 平均耗时（1MB数据） 优化建议 直接内存写入 2.3ms 优先采用内存缓存机制‌ 单次文件写入 8.7ms 批量操作合并写入‌ 分块流式写入 5.1ms 设置合理分块大小‌

2. 优化策略实施

‌事务处理‌：对批量文件操作启用事务机制保障原子性‌ ‌缓存复用‌：对高频访问文件建立LRU内存缓存‌ ‌权限控制‌：通过@ohos.abilityAccessCtrl限制敏感目录访问‌

3. 错误处理规范

try {
await File.copy(srcPath, destPath);
} catch (err) {
if (err.code === 'ENOSPC') {
console.error('存储空间不足');
} else if (err.code === 'EACCES') {
console.error('权限不足');
}
}

四、总结

HarmonyOS Next文件操作体系通过以下技术实现高效开发：

‌标准化接口‌：CoreFileKit提供跨设备的统一文件操作API‌ ‌安全机制‌：系统Picker与权限控制保障用户隐私‌ ‌性能优化‌：流式处理 + 事务机制提升大文件操作效率‌