Node.js递归遍历目录：对象追踪与树形结构构建问题求助

问题核心诊断 #

你遇到的空对象/空children问题，本质是两个常见错误：

• 基准case未正确返回节点数据：处理文件时没有返回有效对象，导致递归链断裂
• 异步递归未等待+节点未挂载：调用递归时未用await，且未将子节点结果追加到父对象的children数组中

错误代码示例（模拟你的场景） #

假设你的原始代码类似这样：

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

async function traverseDir(dirPath) {
  const stats = await fs.stat(dirPath);
  if (!stats.isDirectory()) {
    // 错误：文件节点直接return，无返回值
    return;
  }
  const dirObj = {
    name: path.basename(dirPath),
    type: 'directory',
    children: []
  };
  const files = await fs.readdir(dirPath);
  for (const file of files) {
    const fullPath = path.join(dirPath, file);
    // 错误：未await递归调用，也未将结果存入children
    traverseDir(fullPath);
  }
  return dirObj;
}

控制台会返回空children的目录对象，甚至空对象（如果根节点是文件的极端情况）。

修复后的完整代码 #

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

async function traverseDir(dirPath) {
  const stats = await fs.stat(dirPath);
  const baseName = path.basename(dirPath);

  // 基准case：处理文件节点，返回完整属性对象
  if (!stats.isDirectory()) {
    return {
      name: baseName,
      type: 'file'
    };
  }

  // 初始化目录节点结构
  const dirObj = {
    name: baseName,
    type: 'directory',
    children: []
  };

  const files = await fs.readdir(dirPath);
  // 遍历子项，await递归结果并挂载到父节点children
  for (const file of files) {
    const fullPath = path.join(dirPath, file);
    const childNode = await traverseDir(fullPath);
    dirObj.children.push(childNode);
  }

  return dirObj;
}

// 调用验证
traverseDir('./test')
  .then(result => console.log(JSON.stringify(result, null, 2)))
  .catch(err => console.error('遍历失败:', err));

关键修复点 #

• 修正基准case：文件节点返回包含name、type的有效对象，确保递归链中每个节点都能被上层捕获
• 异步等待与节点挂载：用await等待递归完成，将返回的子节点直接push到父对象的children数组，保证树形结构正确构建
• 统一节点格式：文件和目录节点都返回结构一致的对象，便于后续处理

验证结果 #

假设你的目录结构为：

test/
├── subdir1/
│   ├── file1.txt
│   └── file2.js
├── subdir2/
│   └── nested/
│       └── file3.md
└── readme.md

执行后会输出你期望的树形结构：

{
  "name": "test",
  "type": "directory",
  "children": [
    {
      "name": "subdir1",
      "type": "directory",
      "children": [
        {"name": "file1.txt", "type": "file"},
        {"name": "file2.js", "type": "file"}
      ]
    },
    {
      "name": "subdir2",
      "type": "directory",
      "children": [
        {
          "name": "nested",
          "type": "directory",
          "children": [
            {"name": "file3.md", "type": "file"}
          ]
        }
      ]
    },
    {"name": "readme.md", "type": "file"}
  ]
}

内容的提问来源于stack exchange，提问作者Gracias Peterson Claude