Titanium SDK 中的 Node.js fs 模块兼容实现详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00040/article/details/148758730

Titanium SDK 中的 Node.js fs 模块兼容实现详解

概述

Titanium SDK 提供了一个与 Node.js 核心 fs 模块兼容的实现，允许开发者在跨平台移动应用开发中使用熟悉的文件系统操作接口。这个模块模拟了标准 POSIX 函数的操作方式，为文件系统交互提供了统一的方法。

模块导入

要使用这个模块，只需像在 Node.js 中一样导入：

const fs = require('fs');

同步与异步操作

所有文件系统操作都提供了同步和异步两种形式：

异步操作：接受回调函数作为最后一个参数
同步操作：方法名以 Sync 结尾，直接返回结果或抛出异常

核心功能支持

文件操作

文件访问检查
- fs.access(path[, mode], callback) / fs.accessSync(path[, mode])
- 检查用户对指定路径的权限
- 模式参数可选，默认为 fs.constants.F_OK（检查文件是否存在）
文件追加
- fs.appendFile(path, data[, options], callback) / fs.appendFileSync(path, data[, options])
- 异步/同步追加数据到文件，文件不存在则创建
文件复制
- fs.copyFile(src, dest[, mode], callback) / fs.copyFileSync(src, dest[, mode])
- 支持多种复制模式（通过位掩码组合）：
  - COPYFILE_EXCL：目标存在则失败
  - COPYFILE_FICLONE：尝试创建写时复制链接
文件存在检查
- fs.exists(path, callback) / fs.existsSync(path)
- 检查路径是否存在（注意：exists方法回调接收布尔值而非错误）

目录操作

目录创建
- fs.mkdir(path[, options], callback) / fs.mkdirSync(path[, options])
- 支持递归创建目录（recursive: true）
临时目录创建
- fs.mkdtemp(prefix[, options], callback) / fs.mkdtempSync(prefix[, options])
- 创建唯一临时目录，前缀避免使用尾随'X'字符

文件状态查询

文件描述符状态
- fs.fstat(fd[, options], callback) / fs.fstatSync(fd[, options])
- 通过文件描述符获取文件状态
符号链接状态
- fs.lstat(path[, options], callback) / fs.lstatSync(path[, options])
- 查询符号链接本身的状态

重要注意事项

不支持的功能

Titanium 的 fs 模块实现目前有以下限制：

不支持 Promise API：仅支持回调形式的异步操作
流操作不支持：
- createReadStream
- createWriteStream
部分高级功能不支持：
- 符号链接相关操作（symlink, readlink等）
- 文件截断（ftruncate）
- 文件时间修改（futimes）
- 目录迭代（opendir）

无操作实现

以下方法在 Titanium 中仅为兼容性存在，实际不执行任何操作：

chmod/chmodSync
chown/chownSync
fchmod/fchmodSync
fchown/fchownSync
fdatasync/fdatasyncSync

实用技巧

错误处理：始终检查回调中的错误参数或捕获同步操作的异常
路径处理：使用 path 模块处理跨平台路径问题
性能考虑：在UI线程避免使用同步操作
递归目录：创建嵌套目录时使用 {recursive: true} 选项

最佳实践示例

const fs = require('fs');
const path = require('path');

// 安全地创建目录结构
function ensureDirectoryExists(dirPath) {
  if (!fs.existsSync(dirPath)) {
    fs.mkdirSync(dirPath, { recursive: true });
  }
}

// 异步文件操作示例
function appendToLogFile(message) {
  const logPath = path.join(Ti.Filesystem.applicationDataDirectory, 'app.log');
  fs.appendFile(logPath, `${new Date().toISOString()} - ${message}\n`, (err) => {
    if (err) console.error('写入日志失败:', err);
  });
}