Node.js 控制台日志对齐技巧：让不同位数数字实现等宽输出

在日常开发中，我们经常会通过 console.log 输出调试信息，例如文件数量、任务进度或统计数据。然而，当数字位数不一致时，日志会显得参差不齐，影响可读性，尤其是在批量输出或对比数据时更加明显。

本文将总结几种常见的实现方式，帮助你在 Node.js 或浏览器环境中实现数字的等宽对齐输出。

问题背景

例如如下代码：

console.log(new Date(), list[0][i].id, file_count1, file_count2, file_count1 > file_count2);

当 file_count1 和 file_count2 的位数不同，输出类似：

2026-04-01T10:00:00.000Z 123 12 1234 true
2026-04-01T10:00:01.000Z 124 123 45 false

可以看到数字列完全无法对齐，阅读体验较差。

使用 padStart 实现等宽对齐

最直接的方式是使用字符串的 padStart 方法，将数字转换为固定宽度：

console.log(
  new Date(),
  list[0][i].id,
  String(file_count1).padStart(5, ' '),
  String(file_count2).padStart(5, ' '),
  file_count1 > file_count2
);

输出效果：

   12
  123
 1234

该方法通过在字符串左侧补空格，实现右对齐。

封装格式化函数

在实际项目中，可以将对齐逻辑封装成通用函数：

function formatNum(num, width = 5) {
  return num.toString().padStart(width, ' ');
}

console.log(
  new Date(),
  list[0][i].id,
  formatNum(file_count1, 6),
  formatNum(file_count2, 6),
  file_count1 > file_count2
);

这样可以在多个日志场景中复用，保持输出风格一致。

使用 Intl.NumberFormat 补零格式化

如果希望数字统一补零而不是补空格，可以使用国际化格式工具：

const formatter = new Intl.NumberFormat('en-US', {
  minimumIntegerDigits: 5,
  useGrouping: false
});

console.log(
  formatter.format(file_count1),
  formatter.format(file_count2)
);

输出结果：

00012
00123
01234

这种方式适合需要固定长度数字（例如序号、编号）的场景。

关于 console.log 格式化占位符

Node.js 支持类似 %d 的占位符：

console.log('%d %d', file_count1, file_count2);

但该方式不支持宽度控制，无法实现对齐效果，因此在该场景下作用有限。

优化日志结构

在实际开发中，可以进一步优化日志格式，使其更易读：

console.log(
  `[${new Date().toISOString()}]`,
  `id=${list[0][i].id}`,
  `count1=${String(file_count1).padStart(6)}`,
  `count2=${String(file_count2).padStart(6)}`,
  `gt=${file_count1 > file_count2}`
);

输出示例：

[2026-04-01T10:00:00.000Z] id=123 count1=    12 count2=  1234 gt=true

通过固定宽度和结构化字段，日志信息更加清晰直观。

总结

在控制台输出中实现数字对齐，本质是对字符串进行格式化处理。常见方式包括：

• 使用 padStart 实现空格补齐
• 封装通用格式化函数
• 使用 Intl.NumberFormat 进行补零格式化

通过这些方法，可以显著提升日志的可读性，在调试和分析过程中更加高效。