Node.js fs.access检测C:\Program Files权限无报错但mkdir抛EPERM问题

Windows的文件权限模型里，fs.access仅检查文件/目录是否存在以及当前用户能否读取元数据，并不会验证实际的写入/创建权限。C:\Program Files对普通用户开放读取元数据权限，但创建子目录必须要有管理员权限，这就是access返回正常但mkdir抛出EPERM错误的核心原因。

1. 替换权限检测逻辑：直接尝试创建测试目录 #

不要依赖fs.access做预检测，直接模拟实际创建操作并捕获错误，这是最可靠的方式：

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

async function checkWritePermission(targetDir) {
  const testDir = path.join(targetDir, '.temp-perm-test');
  try {
    // 禁用递归，仅测试当前目标目录的创建权限
    await fs.mkdir(testDir, { recursive: false });
    await fs.rm(testDir); // 清理临时测试目录
    return true;
  } catch (err) {
    if (err.code === 'EPERM') {
      return false;
    }
    // 其他错误（如路径不存在等）单独处理
    throw err;
  }
}

2. 结合SudoPrompt实现提权创建 #

当检测到权限不足时，调用SudoPrompt触发提权流程（Windows下弹出UAC，Linux/macOS下调用sudo）：

const sudo = require('sudo-prompt');

async function createDirWithPrivilege(targetDir) {
  // 路径含空格时必须加引号，避免命令解析出错
  const command = `mkdir "${targetDir}"`;
  return new Promise((resolve, reject) => {
    sudo.exec(command, { name: '你的应用名称' }, (error) => {
      error ? reject(error) : resolve();
    });
  });
}

3. 默认路径的前置提示优化 #

若用户选择默认的C:\Program Files路径，可提前告知该目录需要管理员权限，避免后续操作失败带来的困惑。

• Node.js官方文档明确说明：fs.access不适合用来预判后续操作的可行性，检测与实际操作之间可能出现权限变化（竞态条件），直接尝试操作并捕获错误才是正确做法。
• Windows系统目录（如C:\Program Files、C:\Windows）默认受UAC保护，普通用户仅有读取权限，写入或创建操作必须提权。

内容的提问来源于stack exchange，提问作者Nathaniel M.