怎么利用 String.format() 格式化输出带百分号或千分位的数字字符串

百分号显示总被吃掉一个，怎么保留完整的 % 符号

相信不少开发者都踩过这个坑：在String.format()里，%符号是格式化的转义起始符。如果你直接写"%d%"，程序会毫不犹豫地抛出一个UnknownFormatConversionException——原因很简单，解析器把第二个%当成了格式说明符的一部分，但后面却没有跟上合法的转换字符。

那正确的姿势是什么？记住一个原则：想要输出一个字面量的百分号，就必须用两个连续的%%来表示。看下面这个例子就明白了：

String s = String.format("完成度：%d%%", 95); // 输出：完成度：95%

这个技巧在生成进度报告、配置日志模板或者拼接SQL注释时特别常用。一句话总结：只要你的字符串里需要显式地输出一个%符号，别犹豫，双写就对了。

千分位分隔符在不同 Locale 下行为不一致

接下来聊聊千分位分隔符。使用%,d或%,.2f这类格式符时，有一个隐藏的“陷阱”：它的行为严重依赖于当前的Locale（区域设置）。

举个例子，String.format(Locale.US, "%,d", 1000000)会输出我们熟悉的1,000,000。但如果你不指定Locale，在中文环境下，它很可能直接输出1000000——因为中文默认不使用千分位分隔符。更糟糕的是，在某些旧的JDK版本里，这种不一致甚至可能导致异常。

所以，最稳妥的做法是什么？显式指定Locale。通常推荐使用Locale.US或Locale.ENGLISH来确保千分位逗号能正确显示：

• 整数：String.format(Locale.US, "%,d", 1234567) → 1,234,567
• 浮点数：String.format(Locale.US, "%,.2f", 1234567.891) → 1,234,567.89

尤其是在服务器多语言环境或容器化部署的场景下，依赖系统默认Locale就像在走钢丝，显式指定才是避免意外的最佳实践。

整数加千分位再加百分号，顺序和转义容易搞混

现在我们来个“组合题”：如果想输出像12,345%这样同时带有千分位和百分号的字符串，该怎么写？

常见的错误有两种：一是写成"%,d%"，这会因为百分号转义失败而解析错误；二是写成"%,d%%"，这虽然能运行，但仔细看，它输出的是12345%，千分位分隔符不见了！问题出在哪？

关键在于理解格式符的构成：千分位修饰符,必须紧贴在类型符（比如d或f）前面，而%%是独立表示字面量百分号的。正确的写法如下：

String s = String.format(Locale.US, "%,d%%", 12345); // 正确输出：12,345%

如果是用浮点数表示百分比（比如99.99%），这里还有一个细节：需要先将小数乘以100，再进行格式化。

double rate = 0.9999;
String s = String.format(Locale.US, "%,.2f%%", rate * 100); // 输出：99.99%

性能敏感场景下，别在循环里反复调用 String.format()

最后，聊点性能相关的话题。String.format()虽然方便，但它的底层会创建Formatter实例并解析格式字符串，开销比直接的字符串拼接或使用StringBuilder要大得多。

因此，在高频日志记录、实时计算或者游戏的主循环这类性能敏感的场景中，需要格外小心。有时候，看似“丑陋”的"%" + value + "%"拼接方式，反而速度更快。如果确实需要格式化的功能，可以考虑预编译格式字符串或者使用MessageFormat并缓存其实例来优化。

另外，对于Android开发者来说，低版本API对某些格式符的支持可能不全，真机测试往往比单纯依赖文档更可靠。

说到底，千分位和百分号单独使用都不难，真正的挑战在于它们组合叠加时，转义的优先级和Locale的隐式行为。这两个地方一旦出错，排查起来往往很头疼，因为从异常信息里，你很可能根本看不出是哪里少了一个%。