Java中String.format仅返回第一个参数？原因及正确用法解析

你遇到的不是Java的bug，而是误用了String类的实例方法format，而非用于格式化的静态方法。

现象背后的原因 #

Java的String类有两个同名的format方法：

• 一个是静态方法String.format(String format, Object... args)：这才是我们常用的格式化方法，接收模板字符串和参数，按模板填充后返回结果。
• 另一个是实例方法String.format(Object... args)：这个方法的设计目的和格式化无关，它的逻辑是：如果传入的参数数组非空，直接返回第一个参数的字符串表示（调用args[0].toString()）；如果参数为空，返回调用该方法的字符串实例本身（也就是你的模板字符串）。

你写的代码"name: %s, age: %d".format("bob", 42)调用的是这个实例方法，所以自然会返回第一个参数"bob"，完全忽略模板内容。

对比Python的str.format：Python的字符串实例方法format就是设计用来做模板填充的，和Java的静态String.format功能对应，所以你用相同逻辑在Python里能得到预期结果。

关于面向对象的第一个参数：Java的实例方法中this是隐式的第一个参数，但这和当前问题无关——问题的核心是你调用的方法本身就不是用来做格式化的，它的功能和静态的格式化方法完全不同。

正确的使用方式 #

要实现模板格式化，有两种可靠方式：

1. 使用String类的静态format方法 #

这是最常用的方式，语法和你预期的一致：

String s = String.format("name: %s, age: %d", "bob", 42);
assertEquals("name: bob, age: 42", s); // 执行成功

2. 使用MessageFormat类（支持索引占位符） #

如果习惯类似Python的实例方法调用风格，可以用java.text.MessageFormat，它的占位符用{0}、{1}这样的索引表示：

import java.text.MessageFormat;

// ...

String s = MessageFormat.format("name: {0}, age: {1}", "bob", 42);
assertEquals("name: bob, age: 42", s); // 执行成功

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