老肩巨滑 發表於 2026-1-13 11:15:28

Java字符串格式化工具String.format()完整用法指南

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li>前言</li><li>一、基础认知</li><ul class="second_class_ul"><li>核心作用</li><li>核心语法</li></ul><li>二、格式说明符的完整结构</li><ul class="second_class_ul"></ul><li>三、全量常用转换符</li><ul class="second_class_ul"></ul><li>四、综合实战示例（覆盖所有核心场景）</li><ul class="second_class_ul"></ul><li>五、注意事项</li><ul class="second_class_ul"></ul><li>六、核心总结</li><ul class="second_class_ul"></ul></ul></div><p class="maodian"></p><h2>前言</h2>
<p><code>String.format()</code>是 Java 中最核心的字符串格式化工具，能根据指定模板和参数生成标准化字符串，替代硬编码拼接，提升代码可读性和跨平台兼容性。以下是其完整、系统的用法讲解。</p>
<p class="maodian"></p><h2>一、基础认知</h2>
<p class="maodian"></p><h3>核心作用</h3>
<p>将普通文本与动态参数按指定格式拼接，返回格式化后的字符串（类似 C 语言<code>printf</code>，但不直接输出，仅返回字符串）。</p>
<p class="maodian"></p><h3>核心语法</h3>
<p>提供两个重载方法，日常开发中前者更常用：</p>
<div class="jb51code"><pre class="brush:java;">// 1. 默认本地环境（Locale）：适配当前系统的数字/日期格式
public static String format(String format, Object... args)

// 2. 指定本地环境：比如强制使用英文/中文区域的日期/数字格式
public static String format(Locale l, String format, Object... args)
</pre></div>
<ul><li><code>format</code>：格式模板，包含<strong>普通文本</strong>和以<code>%</code>开头的<strong>格式说明符</strong>（占位符）；</li><li><code>args</code>：可变参数，按顺序匹配模板中的占位符（可通过参数索引复用 / 乱序）。</li></ul>
<p class="maodian"></p><h2>二、格式说明符的完整结构</h2>
<p>格式说明符是<code>String.format()</code>的核心，决定参数的格式化规则，完整结构如下：</p>
<div class="jb51code"><pre class="brush:java;">%[参数索引$][标志][宽度][.精度]转换符
</pre></div>
<p>各部分含义（必选 / 可选标注）：</p>
<table><thead><tr><th>组成部分</th><th>是否必选</th><th>说明</th></tr></thead><tbody><tr><td><code>%</code></td><td>是</td><td>格式说明符的起始标记。</td></tr><tr><td>参数索引 $</td><td>否</td><td>指定使用第几个参数（如<code>%2$d</code>表示第二个参数作为整数），可复用参数。</td></tr><tr><td>标志</td><td>否</td><td>格式化修饰符（如左对齐、补零、千分位、显示正负号）。</td></tr><tr><td>宽度</td><td>否</td><td>指定输出的最小字符数（不足时补空格 / 零，超出则按实际长度）。</td></tr><tr><td>. 精度</td><td>否</td><td>浮点数：指定小数位数；字符串：指定截取长度；整数 / 字符：无意义。</td></tr><tr><td>转换符</td><td>是</td><td>核心，指定参数的类型（如整数、字符串、日期、进制）。</td></tr></tbody></table>
<p class="maodian"></p><h2>三、全量常用转换符</h2>
<p>转换符决定参数的解析类型，以下是覆盖 99% 场景的全量常用转换符（标注「补充」为之前额外新增的）：</p>
<table><thead><tr><th>转换符</th><th>类型</th><th>说明</th><th>示例（参数）</th><th>输出效果</th></tr></thead><tbody><tr><td><code>d</code></td><td>整数（十进制）</td><td>常规整数格式化</td><td><code>%d</code>&nbsp;(123)</td><td>123</td></tr><tr><td><code>s</code></td><td>字符串</td><td>任意对象都会调用<code>toString()</code>转为字符串</td><td><code>%s</code>&nbsp;(&quot;Java&quot;)</td><td>Java</td></tr><tr><td><code>c</code></td><td>字符</td><td>单个字符，参数为<code>char</code>或<code>int</code>（ASCII 码）</td><td><code>%c</code>&nbsp;(&#39;A&#39;)</td><td>A</td></tr><tr><td><code>b</code></td><td>布尔值</td><td>非<code>null</code>/ 非<code>false</code>则输出<code>true</code>，否则<code>false</code></td><td><code>%b</code>&nbsp;(true)</td><td>true</td></tr><tr><td><code>f</code></td><td>浮点数（小数）</td><td>默认保留 6 位小数，可通过精度调整</td><td><code>%f</code>&nbsp;(3.1415)</td><td>3.141500</td></tr><tr><td><code>e</code></td><td>科学计数法</td><td>浮点数转为科学计数法格式</td><td><code>%e</code>&nbsp;(123.45)</td><td>1.234500e+02</td></tr><tr><td><code>t</code>/<code>T</code></td><td>日期时间</td><td>配合子转换符使用（如<code>%tY</code>= 年份），<code>T</code>表示结果大写</td><td><code>%tY</code>&nbsp;(new Date())</td><td>2025</td></tr><tr><td><code>%tF</code></td><td>日期（ISO 标准）</td><td>【补充】快捷格式，等价于<code>%tY-%tm-%td</code>，输出<code>yyyy-MM-dd</code></td><td><code>%tF</code>&nbsp;(new Date())</td><td>2025-12-26</td></tr><tr><td><code>%tD</code></td><td>日期（美式）</td><td>【补充】快捷格式，等价于<code>%tm/%td/%ty</code>，输出<code>MM/dd/yy</code></td><td><code>%tD</code>&nbsp;(new Date())</td><td>12/26/25</td></tr><tr><td><code>x</code>/<code>X</code></td><td>十六进制整数</td><td>【补充】<code>%x</code>小写（a-f），<code>%X</code>大写（A-F）</td><td><code>%X</code>&nbsp;(255)</td><td>FF</td></tr><tr><td><code>o</code></td><td>八进制整数</td><td>【补充】十进制转八进制</td><td><code>%o</code>&nbsp;(10)</td><td>12</td></tr><tr><td><code>%%</code></td><td>百分号本身</td><td>【补充】转义输出<code>%</code>，直接写<code>%</code>会报错</td><td><code>%%</code>&nbsp;()</td><td>%</td></tr><tr><td><code>%n</code></td><td>换行符</td><td>【补充】跨平台换行（Windows=<code>\r\n</code>，Linux=<code>\n</code>），替代硬编码<code>\n</code></td><td><code>%n</code>&nbsp;()</td><td>系统对应换行符</td></tr></tbody></table>
<p class="maodian"></p><h2>四、综合实战示例（覆盖所有核心场景）</h2>
<p>以下示例整合了基础用法和补充格式符，可直接复制运行：</p>
<div class="jb51code"><pre class="brush:java;">import java.util.Date;
import java.util.Locale;

public class StringFormatCompleteDemo {
    public static void main(String[] args) {
      Date now = new Date();
      
      // ========== 场景1：基础类型格式化（字符串、整数、浮点数、布尔、字符） ==========
      String basic = String.format(
            "姓名：%s，年龄：%d，成绩：%.2f，是否及格：%b，等级：%c",
            "张三", 25, 89.567, true, 'A'
      );
      System.out.println("基础类型：" + basic);
      // 输出：姓名：张三，年龄：25，成绩：89.57，是否及格：true，等级：A

      // ========== 场景2：宽度/标志修饰（补零、左对齐、千分位、正负号） ==========
      String modifier = String.format(
            "编号：%05d，姓名：%-10s，金额：%,d 元，温度：%+d℃",
            123, "李四", 1234567, -5
      );
      System.out.println("宽度/标志：" + modifier);
      // 输出：编号：00123，姓名：李四      ，金额：1,234,567 元，温度：-5℃

      // ========== 场景3：日期时间格式化（含快捷格式%tF/%tD） ==========
      String date = String.format(
            "ISO日期：%tF，美式日期：%tD，完整时间：%tF %tT%n",
            now, now, now, now
      );
      System.out.println("日期时间：" + date);
      // 输出：ISO日期：2025-12-26，美式日期：12/26/25，完整时间：2025-12-26 15:30:45（示例）

      // ========== 场景4：进制转换（十六进制%X、八进制%o） ==========
      String radix = String.format(
            "255的十六进制（大写）：%04X，10的八进制：%03o",
            255, 10
      );
      System.out.println("进制转换：" + radix);
      // 输出：255的十六进制（大写）：00FF，10的八进制：012

      // ========== 场景5：特殊符号（百分号%%、跨平台换行%n） ==========
      String special = String.format(
            "成功率：%.1f%%%n第一行内容%n第二行内容",
            99.5
      );
      System.out.println("特殊符号：" + special);
      // 输出：成功率：99.5%
      // 第一行内容
      // 第二行内容

      // ========== 场景6：参数索引（复用/乱序参数） ==========
      String index = String.format(
            "数字：%2$d，字符串：%1$s，再次使用数字：%2$d",
            "测试", 666
      );
      System.out.println("参数索引：" + index);
      // 输出：数字：666，字符串：测试，再次使用数字：666
    }
}
</pre></div>
<p class="maodian"></p><h2>五、注意事项</h2>
<ol><li><strong>参数匹配</strong>：占位符数量需与参数数量匹配（参数索引复用除外），否则抛<code>MissingFormatArgumentException</code>；</li><li><strong>类型匹配</strong>：转换符需与参数类型匹配（如<code>%d</code>不能接收字符串），否则抛<code>IllegalFormatConversionException</code>；</li><li><strong>浮点数精度</strong>：<code>%.2f</code>会自动四舍五入（如<code>3.145</code>&rarr;<code>3.15</code>）；</li><li><strong>转义规则</strong>：输出<code>%</code>必须用<code>%%</code>，直接写<code>%</code>会被识别为格式符起始标记导致报错；</li><li><strong>跨平台兼容</strong>：优先用<code>%n</code>替代<code>\n</code>，避免 Windows/Linux 换行符不一致问题；</li><li><strong>日期参数</strong>：<code>%tF/%tD</code>仅支持<code>Date</code>/<code>Calendar</code>/<code>LocalDateTime</code>等日期类型参数。</li></ol>
<p class="maodian"></p><h2>六、核心总结</h2>
<ol><li><strong>核心结构</strong>：格式说明符的核心是<code>%</code>+<code>转换符</code>（必选），参数索引、标志、宽度、精度为可选修饰，可灵活控制输出样式；</li><li><strong>高频转换符</strong>：<ul><li>基础类型：<code>%d</code>（整数）、<code>%s</code>（字符串）、<code>%f</code>（浮点数）；</li><li>日期：<code>%tF</code>（ISO 标准日期）、<code>%tT</code>（完整时间）；</li><li>特殊场景：<code>%X</code>（十六进制）、<code>%%</code>（百分号）、<code>%n</code>（跨平台换行）；</li></ul></li><li><strong>最佳实践</strong>：避免硬编码拼接字符串，用<code>String.format()</code>实现标准化输出；优先用<code>%tF/%tT</code>简化日期格式化，用<code>%n</code>保证跨平台兼容性。</li></ol>
<p>到此这篇关于Java字符串格式化工具String.format()完整用法的文章就介绍到这了,更多相关Java&nbsp;String.format&nbsp;()用法内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！</p>
                           
                            <div class="art_xg">
                              <b>您可能感兴趣的文章:</b><ul><li>Java&nbsp;String.format()的用法</li><li>JAVA字符串格式化-String.format()的使用</li><li>快速入门介绍Java中强大的String.format()</li><li>Java之String.format()方法案例讲解</li><li>Java&nbsp;格式化输出String.format()&nbsp;示例解析</li></ul>
                            </div>

                        </div>
                        <!--endmain-->
頁: [1]
查看完整版本: Java字符串格式化工具String.format()完整用法指南