Node.js中fs.writeFile路径错误及动态创建目录解决方案

问题分析 #

你的问题主要有两个核心原因：

1. 相对路径解析错误：Node.js中相对路径是基于当前工作目录（process.cwd()），而不是你执行脚本的所在目录。如果你的test.js在parent/childDir/tests/testDir1，而你是在该目录下运行node test.js，那么传入的resultPath: 'parent/childDir/data/resultsDir'会被解析成parent/childDir/tests/testDir1/parent/childDir/data/resultsDir——这显然不是你想要的，甚至可能因为目录不存在，导致fs.writeFile默认在CWD下创建文件（也就是parent/childDir/tests/testDir1）。
2. 未提前创建目标目录：你的writeDataToFile函数没有调用ensureDirectoryExists，导致目标目录不存在时，fs.writeFile无法正确写入到指定路径，进而出现路径异常。

另外，你的ensureDirectoryExists函数还有一个小问题：递归创建父目录后，直接调用fs.mkdirSync可能会遇到目录已存在的错误，需要优化；同时writeDataToFile函数缺少data参数（你在函数里用了data但没定义）。

修复步骤 #

1. 优化ensureDirectoryExists函数

调整递归逻辑，添加recursive: true参数避免重复创建目录的错误，同时确保层级目录都能被正确创建：

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

function ensureDirectoryExists(filePath) {
  const dirname = path.dirname(filePath);
  // 如果目录已存在，直接返回
  if (fs.existsSync(dirname)) {
    return true;
  }
  // 递归创建父级目录
  ensureDirectoryExists(dirname);
  // 创建当前目录，recursive: true 允许创建多级目录，且避免已存在的错误
  fs.mkdirSync(dirname, { recursive: true });
}

2. 修复路径解析问题（关键）

确保getFilePath返回绝对路径，避免当前工作目录的影响。这里假设你的resultPath是相对于项目根目录（parent/childDir）的路径，我们可以基于test.js的位置来定位项目根：

function getFilePath(fileName, resultPath) {
  // __dirname 是当前脚本（test.js）所在的目录：parent/childDir/tests/testDir1
  // ../../ 定位到项目根目录：parent/childDir
  const projectRoot = path.resolve(__dirname, '../../');
  // 拼接项目根、目标路径和文件名，得到绝对路径
  return path.join(projectRoot, resultPath, fileName);
}

如果你希望resultPath是绝对路径，直接传入即可，这个函数也能正常工作。

3. 修改writeDataToFile函数

添加缺失的data参数，在写入文件前调用ensureDirectoryExists确保目录存在，同时打印完整路径方便调试：

export function writeDataToFile(fileName, resultPath, data) {
  const fullFilePath = getFilePath(fileName, resultPath);
  // 先确保目标目录存在
  ensureDirectoryExists(fullFilePath);
  
  fs.writeFile(fullFilePath, data, function (err) {
    if (err) {
      console.error('Error writing file:', err);
      return;
    }
    console.log(`File saved successfully to: ${fullFilePath}`);
  });
}

4. 调用示例（test.js中）

const { writeDataToFile } = require('./your-module-path');

// 调用时传入文件名、目标路径和要写入的数据
writeDataToFile(
  'output.json',
  'data/resultsDir', // 现在可以简化路径，因为已经基于项目根解析
  JSON.stringify({ key: 'value' })
);

额外说明 #

• 如果你不确定当前工作目录，可以在代码中打印process.cwd()来排查路径问题。
• 从Node.js 10开始，fs.mkdirSync支持recursive: true，其实你可以直接用fs.mkdirSync(path.dirname(fullFilePath), { recursive: true })替代ensureDirectoryExists函数，代码会更简洁，但既然你要求使用该函数，上面的优化版本已经能满足需求。

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