Java日志输出：如何避免字符串拼接实现参数化错误日志？

当然有好多更优雅的办法啦，完全不用再纠结字符串拼接带来的顺序问题！下面给你几种常用且靠谱的方案，适配大部分主流日志框架：

1. 用日志框架自带的参数化日志（首推！） #

几乎所有现代日志框架（比如SLF4J、Logback、Log4j2）都原生支持参数化日志，用{}作为占位符就可以。框架会自动帮你把变量插入到对应位置，不管是左到右还是右到左的语言场景，顺序都不会出错，还能提升日志性能（如果当前日志级别没开启，不会提前做字符串拼接操作）。

示例代码：

logger.error("Entered value [{}] is wrong", val);

2. 使用String.format()格式化 #

如果你的日志框架不支持参数化，或者你更习惯这种写法，可以用String.format()来处理变量插入，用%s（对应字符串类型，其他类型可以用%d、%f等）作为占位符，拼接逻辑由JDK帮你处理，顺序绝对不会乱。

示例代码：

logger.error(String.format("Entered value [%s] is wrong", val));

这种方式还支持更复杂的格式控制，比如数字保留小数、日期格式化等，灵活性很高。

3. Java 15+ 文本块配合formatted()方法 #

如果你的项目用的是Java 15及以上版本，还可以用文本块（Text Blocks）结合formatted()方法，写法更直观，尤其适合多行日志场景：

示例代码：

logger.error("""
    Entered value [%s] is wrong
    """.formatted(val));

额外好处 #

这些方案除了解决你担心的右到左读取顺序问题，还有这些优势：

• 避免空指针异常：如果val是null，参数化日志会自动显示为"null"，而字符串拼接可能直接抛出异常
• 代码可读性更高：一眼就能看出变量要插入的位置
• 性能更优：参数化日志只有在日志级别生效时才会执行字符串拼接，减少不必要的性能消耗

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