规范使用{}占位符可提升性能、可读性与安全性，参数延迟求值，避免无效拼接；需预处理null和表达式，敏感信息须脱敏，按日志级别匹配内容，并统一使用Logger而非printf。
Java 日志输出中，规范使用占位符（{}）是提升性能、增强可读性与保障安全的关键实践。它不是语法糖，而是日志框架（如 Logback、Log4j2、SLF4J）明确支持的延迟求值机制——参数只在日志实际启用时才参与字符串拼接，避免无效构造。
必须用 {} 占位符替代字符串拼接
错误写法会强制执行字符串拼接，即使日志级别被关闭（如 DEBUG 关闭时），仍消耗 CPU 和内存：
✘ 不推荐logger.debug("用户 " + userName + " 登录失败，耗时 " + duration + "ms");
logger.debug("用户 {} 登录失败，耗时 {}ms", userName, duration);
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
多个参数按顺序依次填入 {}，支持任意数量（不限两个），框架自动匹配并类型安全转换（调用 toString()）。
禁止在占位符中传入 null 或复杂表达式
占位符本身不支持空值判空或逻辑运算，应由业务代码预处理：
- 避免直接传
null：若user可能为 null，先转成字符串再传，如String.valueOf(user)或Optional.ofNullable(user).map(User::getId).orElse("unknown") - 不写表达式：✘
logger.info("结果: {}", list.size() > 0 ? "success" : "empty")→ 应提前计算好变量 - 敏感信息需脱敏后再传：如手机号
"138****1234"，而非原始值
结合日志级别选择是否记录
占位符写法本身不改变日志级别语义，但要确保内容与级别匹配：
-
INFO：记录关键业务动作，如
"订单 {} 创建成功，金额 {} 元" -
WARN：记录可恢复异常，如
"支付回调重复，订单号 {}，重复次数 {}" -
ERROR：记录不可恢复故障，建议附加异常对象：
logger.error("数据库更新失败，订单 {}，原因：{}", orderId, e.getMessage(), e)（第三个参数传 Throwable，才能打印堆栈）
控制台调试时慎用 printf，优先保持日志风格统一
虽然 System.out.printf() 支持 %s、%d 等 C 风格格式，但它属于临时调试手段，不具备日志级别控制、异步写入、文件滚动等能力。生产代码中应统一走 Logger 接口，避免混用：
- 调试阶段可用
System.out.printf()快速对齐输出，但上线前必须删除或替换 - 若需格式化数字/时间，应在参数侧处理好（如
String.format("%.2f", rate)），再传给 logger 的 {} 占位符 - 不要在 logger 中混用
%d或%s—— SLF4J / Logback 的 {} 是专用语法，与 printf 无关
