Node.js中检测文件存在或状态主要用fs模块。①fs.existsSync同步判断,简单但不推荐高并发;②fs.access异步检查可访问性,支持F_OK/R_OK/W_OK,更安全;③fs.stat获取详细信息,可区分文件/目录;④推荐使用fs.promises配合async/await,代码更清晰可靠。

在Node.js中检测文件是否存在或获取其状态,主要依赖内置的fs模块。以下是几种常用方法,适用于不同场景。
使用 fs.existsSync 检测文件是否存在
这是最简单直接的方式,用于同步判断文件或目录是否存在。
注意:由于是同步操作,不建议在高并发场景频繁使用。
示例:
const fs = require('fs');
if (fs.existsSync('./example.txt')) {
console.log('文件存在');
} else {
console.log('文件不存在');
}
使用 fs.access 检查文件可访问性(推荐异步方式)
fs.access 可以检查文件是否可读、可写或是否存在,更贴近实际使用权限。
常用常量:
- fs.constants.F_OK:检查文件是否存在
- fs.constants.R_OK:检查可读
- fs.constants.W_OK:检查可写
示例:
const fs = require('fs');
fs.access('./example.txt', fs.constants.F_OK, (err) => {
if (err) {
console.log('文件不存在或无法访问');
} else {
console.log('文件存在');
}
});
使用 fs.stat 获取文件详细信息
如果你想进一步判断是文件还是目录,可以使用 fs.stat 或 fs.lstat(处理符号链接)。
示例:
const fs = require('fs');
fs.stat('./example.txt', (err, stats) => {
if (err) {
console.log('文件不存在');
return;
}
if (stats.isFile()) {
console.log('这是一个文件');
}
if (stats.isDirectory()) {
console.log('这是一个目录');
}
console.log('文件大小:', stats.size, '字节');
});
使用 promises 版本(现代写法,推荐)
Node.js 提供了 fs/promises,支持 async/await,代码更清晰。
示例:
const fs = require('fs').promises;
async function checkFile() {
try {
await fs.access('./example.txt', fs.constants.F_OK);
console.log('文件存在');
const stats = await fs.stat('./example.txt');
console.log('是否为文件:', stats.isFile());} catch (err) {
console.log('文件检测失败:', err.message);
}
}
check();
基本上就这些。根据你的需求选择合适的方法:快速判断用 existsSync(开发调试),生产环境建议用 fs.access 或 fs.promises.access 配合异步处理,更安全可靠。









