Node.js中fs模块无法读取含空格文件名的文件问题求助

这问题我之前做文件管理工具时也碰到过，核心原因很明确：你传递给fs模块的是URL编码后的路径（比如./Home/My%20Documents），但实际文件系统里的目录名是带真实空格的My Documents，所以scandir找不到对应的路径，直接抛出了ENOENT错误。

问题拆解 #

文件系统操作（不管是Node.js的fs还是其他语言的文件API）只认系统原生路径格式，而URL编码是给HTTP请求用的规范。当你的代码把带空格的文件名自动转成%20后，相当于告诉文件系统"去找一个叫My%20Documents的文件夹"，但实际这个文件夹根本不存在，自然报错。

解决方案 #

分两步就能彻底解决：

1. 先解码URL编码的路径

如果你的路径是从前端请求或者URL参数里拿到的，第一步必须把编码后的路径解码回原始格式。用Node.js的decodeURIComponent()就能搞定：

const encodedPath = './Home/My%20Documents';
const actualPath = decodeURIComponent(encodedPath);
// 现在 actualPath 是 './Home/My Documents'，和系统里的真实路径一致

2. 递归遍历中用原生路径拼接

在递归遍历的逻辑里，绝对不要手动对文件名做URL编码，而是用路径处理工具（比如Node.js的path模块）直接拼接原始文件名：

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

async function traverseDir(currentDir) {
  try {
    const entries = await fs.readdir(currentDir, { withFileTypes: true });
    const dirContents = [];

    for (const entry of entries) {
      // 用path.join自动处理路径分隔符和空格，避免手动拼接出错
      const fullPath = path.join(currentDir, entry.name);
      
      if (entry.isDirectory()) {
        dirContents.push({
          name: entry.name,
          type: 'dir',
          children: await traverseDir(fullPath)
        });
      } else {
        dirContents.push({
          name: entry.name,
          type: 'file',
          path: fullPath
        });
      }
    }
    return dirContents;
  } catch (err) {
    console.error(`遍历目录失败: ${currentDir}`, err);
    throw err;
  }
}

额外提醒：前端传参的正确姿势

如果是前端点击后传递路径到后端，要么直接传递原始带空格的路径（现代浏览器会自动处理HTTP请求中的空格编码，但后端要记得解码），要么前端手动编码后，后端必须解码再用。比如：

// 前端请求示例
fetch(`/api/traverse?path=${encodeURIComponent('./Home/My Documents')}`)

// 后端接收处理
const reqPath = decodeURIComponent(req.query.path);
await traverseDir(reqPath);

这样处理后，不管文件名里有空格、特殊字符（只要是系统允许的），都能正常遍历，不会再出现ENOENT错误。

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