如何通过String.prototype.repeat实现缩进格式的调试日志输出？

本文共计922个文字，预计阅读时间需要4分钟。

`String.prototype.repeat` 是最直接的缩进构造方式，它不包含、不循环、不依赖空格和硬编码字符。传入一个非负整数即可返回重复多次的字符串，例如：

注意：参数必须是整数，" ".repeat(2.5) 会静默截断为 " ".repeat(2)；负数或 Infinity 会抛出 RangeError；NaN 或 undefined 会被转成 0，结果为空字符串。

常见错误是误以为能传入字符串模板，比如 "\t".repeat(level) 看似合理，但制表符在不同终端缩进宽度不一致，日志对齐可能错乱——调试日志应优先用空格保证可预测性。

嵌套调用时避免重复计算缩进层级

在递归结构（如对象深遍历、AST 打印）中，容易在每次递归里重复写 " ".repeat(depth)。这本身没问题，但若 depth 来自不可信输入（如用户传入的 level 参数），需先做校验：

• 用 Math.max(0, Math.floor(depth)) 防止负数或小数引发异常
• 设上限（如 Math.min(10, depth)），避免 " ".repeat(100000) 导致内存暴涨或卡死
• 如果同一层级被高频复用（如打印数百个同级属性），可提前缓存：const indent = " ".repeat(level)，避免重复创建相同字符串

与 console.log 组合输出时的换行控制

直接把 repeat() 结果拼进字符串再传给 console.log 没问题，但要注意换行符位置。错误写法：console.log(indent + "key: " + value + "\n")，末尾多余换行会让日志多一空行。

更稳妥的做法是让缩进只作用于内容前缀，换行由 console.log 自动处理：

console.log(`${indent}key: ${value}`);

若需手动控制换行（如批量输出后统一 flush），用 process.stdout.write() 更精确，此时必须显式加 \n：

process.stdout.write(`${indent}key: ${value}\n`);

另外，某些浏览器或终端对过长单行日志有截断行为，缩进太深（如 > 50 层）可能导致内容不可见，这不是 repeat() 的问题，而是显示层限制——遇到深层嵌套，建议改用折叠式格式（如加前缀 ├─ / └─）而非纯空格缩进。

替代方案对比：模板字符串 vs repeat() vs Array.fill()

有人用 Array(level).fill(" ").join("") 或 " ".repeat(level) 效果一样，但性能差一个数量级（尤其 level 大时）。V8 引擎对 repeat() 有底层优化，而 Array.fill().join() 创建中间数组、触发 GC。

模板字符串如 `${" ".repeat(n)}text` 没问题，但若写成 `{" ".repeat(n)}text`（花括号未包裹表达式），JS 会报语法错误——这是常见笔误。

真正容易被忽略的是 Unicode 空格兼容性："　".repeat(2)（全角空格）视觉宽度是半角的两倍，且 repeat() 对它同样生效，但混用会导致缩进错位。调试日志务必统一用 ASCII 空格 " " 或固定宽度空格对 " "。