使用fs.writeFile写入的文件比console.log多换行的原因及解决方法

云原生阿岚

2026-5-8

问题原因与解决方案

首先，这个问题的核心是Windows系统与Unix类系统的换行符差异：

Windows使用\r\n（CRLF，回车+换行）作为标准换行符
Unix/Linux/macOS使用\n（LF，仅换行）作为标准换行符

你的console.log在PowerShell中输出时，PowerShell会自动识别并正确渲染两种换行符，所以看起来内容正常。但当你直接将带有LF换行符的内容写入文件后，Windows原生工具（比如记事本）只能识别CRLF，会把LF显示为异常符号（或表现为“多余空行”的视觉效果）；而Sublime Text如果默认设置为CRLF模式，也会把LF换行解析成异常的换行表现。

另外，你的代码里有个小问题：async函数的catch块里用reject(err)是无效的——async函数返回的是Promise，抛出错误应该用throw err，而非直接调用reject（这个方法只在Promise构造函数内部有效）。

解决方法

要让写入的文件和console.log输出的视觉效果一致，有两种可行方案：

方案1：将内容中的LF换行转换为CRLF

在写入文件前，把字符串里所有的\n替换成Windows标准的\r\n：

import fs from 'fs/promises'; // 确保导入promises版本的fs模块

async function writeFile(path: string, content: string): Promise<void> {
  console.log(content);
  try {
    // 替换LF为CRLF，适配Windows换行规则
    const windowsCompatibleContent = content.replace(/\n/g, '\r\n');
    await fs.writeFile(path, windowsCompatibleContent, "utf8");
  } catch (err) {
    throw err; // 正确抛出错误，让async函数返回rejected Promise
  }
}