Node.js为何提示Windows系统隐藏文件不存在？

问题重现 #

你在Windows 10上运行Node.js v8.11.2的test函数时，出现了矛盾的结果：readdirSync()列出了C盘根目录下的系统隐藏文件/目录，但existsSync()却判定它们不存在，输出如下：

DOES NOT EXIST ? C:\pagefile.sys DOES NOT EXIST ? C:\hiberfil.sys DOES NOT EXIST ? C:\swapfile.sys DOES NOT EXIST ? C:\System Volume Information

对应的测试函数代码：

function test () { 
  let Fs = require("fs"); 
  let Path = require("path"); 
  let path = "C:/"; 
  let ents = Fs.readdirSync(path) ; 
  let dirs = ents.map ( e => { 
    let absPath = Path.join (path, e); 
    if (! Fs.existsSync(absPath)) { 
      console.log ("DOES NOT EXIST ? " + absPath) 
    } else { 
      console.log ("DOES EXIST: " + absPath) 
    } 
  } ); 
}

核心原因解析 #

这背后的关键是Windows的权限控制和Node.js底层API的差异：

• readdirSync()的作用是读取目录的条目列表，它只需要当前进程拥有对C盘根目录的读取权限就能完成。这些系统文件/目录的名称本身是目录条目的一部分，所以能被列出来。
• 而existsSync()在检查文件/目录是否存在时，底层会调用Windows的GetFileAttributesW API。对于pagefile.sys、hiberfil.sys这类系统核心文件，以及System Volume Information目录，它们不仅是隐藏属性，还被Windows设置了严格的权限——普通用户进程没有访问（甚至读取属性）的权限。当API调用失败时，Node.js会将其判定为“不存在”，返回false。

其他类似情况 #

除了案例中的系统保护文件，还有几种场景也会出现readdirSync()能列出条目，但existsSync()返回false的情况：

• 权限不足的文件/目录：比如其他用户创建的、设置了严格权限的文件，当前进程没有读取权限时，existsSync()会返回false。
• 被独占锁定的文件：如果某个文件被其他进程以独占模式打开，当前进程无法访问该文件的属性，existsSync()也会返回false。
• 损坏的NTFS链接：比如NTFS的硬链接指向的原始文件已被删除，但目录条目还未被系统清理（这种情况比较少见，NTFS通常会自动处理，但极端场景下可能出现）。

是特性还是Bug？ #

这绝对是特性，而非Bug：
Node.js的文件系统API是对操作系统原生API的封装，它的行为完全遵循Windows的权限模型。当进程没有权限访问某个文件时，系统不会返回“存在但无权限”的信息，而是直接返回访问失败——Node.js将这种失败映射为existsSync()返回false，是符合系统设计逻辑的。而readdirSync()能列出条目，也是因为读取目录列表和访问单个文件的权限要求不同。

内容的提问来源于stack exchange，提问作者Panu Logic