Java String.format()：如何正确处理百分号字面量-java教程-PHP中文网

Java String.format()：如何正确处理百分号字面量

聖光之護

发布： 2025-07-23 14:16:34

原创

744人浏览过

Java String.format()：如何正确处理百分号字面量

在Java编程中，String.format()方法是格式化字符串的强大工具，它允许开发者通过占位符来构建动态字符串。然而，当格式字符串中同时包含格式说明符（如%s、%d等）和作为普通字符的百分号（%）时，可能会遇到java.util.UnknownFormatConversionException异常。正如上文摘要所述，本文将深入探讨此问题的根源，并提供简洁明了的解决方案。

理解String.format()的工作原理

string.format()方法是基于java.util.formatter类实现的，它通过解析格式字符串来确定如何格式化参数。在格式字符串中，百分号（%）是一个特殊字符，它标志着一个格式说明符的开始。例如，%s表示将一个字符串参数插入到此处，%d表示一个整数参数。

考虑以下基本用法：

String format = "您的名字是 %s";
String text = String.format(format, "Harry");
System.out.println(text); // 输出: 您的名字是 Harry

登录后复制

这工作正常，因为%s被正确解析并替换为提供的参数。

遇到的问题：字面量百分号的冲突

当您尝试在同一个格式字符串中既使用格式说明符又使用字面量百分号时，问题就出现了。例如，如果您想打印“100%point”：

String format = "您的名字是 %s, 100%point";
String name = String.format(format, "Harry");
System.out.println(name); // 预期输出: 您的名字是 Harry, 100%point

登录后复制

运行上述代码会导致以下运行时错误：

立即学习“Java免费学习笔记（深入）”；

java.util.UnknownFormatConversionException: Conversion = 'p'
    at java.util.Formatter$FormatSpecifier.conversion(Formatter.java:2781)
    ... (部分堆栈信息省略)

登录后复制

这个异常的发生是因为Formatter解析器在遇到100%point中的%p时，将其视为一个不合法的格式说明符。Formatter期望%后面跟着一个有效的转换字符（如s、d、f等），但p不是一个标准的转换字符，因此抛出了UnknownFormatConversionException。它错误地将字面量百分号后面的字符当作了转换字符。

AI封面生成器

专业的AI封面生成工具，支持小红书、公众号、小说、红包、视频封面等多种类型，一键生成高质量封面图片。

108

查看详情

解决方案：转义百分号

要解决这个问题，您需要告诉String.format()方法，某个百分号是作为一个字面量字符而不是一个格式说明符的开始。实现这一点的标准方法是使用双百分号（%%）来转义单个百分号。

当Formatter遇到%%时，它会将其解释为单个字面量百分号字符，并将其插入到输出字符串中，而不会尝试将其解析为格式说明符。

将上述有问题的代码修改为：

String format = "您的名字是 %s, 100%%point"; // 注意这里的 100%%point
String name = String.format(format, "Harry");
System.out.println(name); // 预期输出: 您的名字是 Harry, 100%point

登录后复制

现在，运行这段代码将得到正确的输出：“您的名字是 Harry, 100%point”，并且不会再出现UnknownFormatConversionException。