Java字符串格式化主要有String.format()、printf()和MessageFormat三种方式:前两者基于printf风格,语法简洁;后者专为国际化设计,支持占位符重排序和复数处理。

Java中字符串格式化主要有三种方式:String.format()、printf()(包括System.out.printf和PrintStream.printf)以及MessageFormat。其中前两者基于C语言printf风格,语法简洁统一;后者专为国际化设计,支持占位符重排序和复数处理。
String.format() —— 最常用的安全格式化方式
它返回格式化后的新字符串,不修改原字符串,线程安全,适合拼接日志、SQL语句或模板内容。
- 基本用法:
String result = String.format("Hello %s, you are %d years old", "Alice", 28); - 支持类型转换标识符:%s(字符串)、%d(十进制整数)、%f(浮点数)、%t(日期时间)、%x(十六进制)等
- 可指定宽度、精度和对齐,例如:
%10s(右对齐,最小宽度10)、%.2f(保留两位小数)、%-15s(左对齐) - 支持参数索引复用:
String.format("First: %1$s, Again: %1$s", "test")
printf() 系列 —— 直接输出,适合控制台调试
与String.format()语法完全一致,但直接写入输出流,不返回字符串。常用于快速打印调试信息。
System.out.printf("Value: %.3f, Count: %d%n", 3.14159, 42);-
%n是平台无关的换行符(推荐替代\n) - 注意:printf不会自动换行,需显式加
%n;而println会自动换行,但不支持格式化
MessageFormat —— 国际化友好,支持复杂占位逻辑
适用于多语言场景,占位符使用{index}或{name, type, style}语法,支持日期、数字、选择(choice)等本地化格式。
立即学习“Java免费学习笔记(深入)”;
- 简单示例:
MessageFormat.format("Found {0} {0,choice,0#items|1#item|1 - 支持参数名而非位置:
new MessageFormat("Hello {name}, age {age,number,integer}") - 自动适配Locale:
new MessageFormat(pattern, Locale.CHINA) - 不支持printf中的宽度/对齐等格式修饰,专注语义化表达
注意事项与避坑建议
格式化看似简单,但容易因类型不匹配或参数缺失导致运行时异常(IllegalFormatException)。
- 确保参数数量和类型与格式串严格匹配;建议在IDE中开启格式检查(如IntelliJ的“String manipulation inspection”)
- 避免在循环中频繁调用String.format()拼接大量字符串,考虑用StringBuilder + 手动拼接提升性能
- 处理用户输入作为格式串时(如配置文件读取),必须校验或白名单过滤,防止格式注入攻击
- 日期格式化优先使用DateTimeFormatter(Java 8+),而非
%t系列,后者功能有限且不易维护










