在Node.js及Electron.js环境中如何检测文件是否正被其他应用打开？

核心逻辑 #

不同操作系统的文件锁机制不同，Electron 没有提供统一的跨平台检测 API，可通过调用对应平台的系统命令、或者尝试独占打开文件两种方式实现检测。

实现方案 #

方案1：简易跨平台实现（无需依赖外部工具） #

直接尝试以读写模式打开目标文件，如果抛出占用类错误即可判定文件被其他应用打开，适合轻量场景使用：

const fs = require('fs/promises');

async function isFileOccupied(filePath) {
  try {
    // 尝试以读写模式打开文件
    const fileHandle = await fs.open(filePath, 'r+');
    await fileHandle.close();
    return false;
  } catch (err) {
    // EBUSY为文件被占用错误码，EACCES为无权限（多数场景也是被占用导致）
    return err.code === 'EBUSY' || err.code === 'EACCES';
  }
}

方案2：调用系统命令实现（准确率更高） #

Windows 平台

调用系统工具handle.exe检测文件句柄占用，提前把handle.exe放到应用资源目录即可：

const { exec } = require('child_process');
const path = require('path');
const handleExePath = path.join(process.resourcesPath, 'handle.exe');

async function isFileOccupiedWindows(filePath) {
  return new Promise((resolve) => {
    exec(`"${handleExePath}" "${filePath}" -accepteula`, (err, stdout) => {
      resolve(stdout.includes(path.basename(filePath)));
    });
  });
}

macOS/Linux 平台

调用系统自带的lsof命令即可，无需额外依赖：

const { exec } = require('child_process');

async function isFileOccupiedUnix(filePath) {
  return new Promise((resolve) => {
    exec(`lsof "${filePath}"`, (err, stdout) => {
      resolve(!!stdout.trim());
    });
  });
}

业务流程接入示例 #

const { dialog } = require('electron');
const os = require('os');

async function deleteFile(filePath) {
  let occupied = false;
  const platform = os.platform();
  // 调用对应平台的检测方法
  if (platform === 'win32') {
    occupied = await isFileOccupiedWindows(filePath);
    // 也可以用简易方案：occupied = await isFileOccupied(filePath);
  } else {
    occupied = await isFileOccupiedUnix(filePath);
    // 也可以用简易方案：occupied = await isFileOccupied(filePath);
  }
  // 检测到被占用弹出警告
  if (occupied) {
    dialog.showErrorBox('操作失败', '文件仍处于打开状态，请先关闭后再操作。');
    return;
  }
  // 未被占用则执行删除逻辑
  // await fs.unlink(filePath);
}

注意事项 #

• 文件路径如果包含空格，一定要用引号包裹，避免命令解析出错
• 需要做好命令参数转义，避免命令注入风险

内容的提问来源于stack exchange，提问作者Debotos Das