怎么利用 String.format() 的 %03d 格式化参数生成三位补零的自动递增序列号

用 String.format("%03d", number) 可以轻松把整数变成三位补零的字符串，比如 1 变成 "001"，42 变成 "042"，123 还是 "123"。关键在于把递增的整数传进去，配合循环就能生成序列号。

理解 %03d 的含义

%03d 这个格式化占位符，拆开来看：% 是起始符号，0 表示不足位数时用字符 '0' 填充，3 是最小宽度，d 是十进制整数。所以 String.format("%03d", 5) 得到 "005"，而 String.format("%03d", 100) 得到 "100"——注意只补零不截断，宽度够了就不动。

生成自动递增序列号的基本写法

定义一个起始整数，每次调用前自增，再格式化，就搞定了：

int seq = 1;
String serial = String.format("%03d", seq++); // 得到 "001"，seq 变成 2
String next = String.format("%03d", seq++);    // 得到 "002"

更常见的做法是在循环里用，直接利用循环变量递增：

for (int i = 1; i <= 10; i++) {
    String serialNo = String.format("%03d", i);
    System.out.println(serialNo); // 输出：001, 002, ..., 010
}

实际应用中的扩展建议

纯数字序列号在实际业务中肯定不够用，常常需要加前缀、时间戳或校验位。举例来说：

• 带固定前缀：String.format("ORD-%03d", orderId) → "ORD-042"
• 结合年份：String.format("PO2024-%03d", counter) → "PO2024-007"
• 多线程安全：如果并发生成，用 AtomicInteger 替代普通 int，避免重复
• 超限处理：三位最多支持 001–999，超出范围可以用 %04d 或动态计算位数

注意事项

最后，几个容易踩的坑提醒一下：

• 参数必须是 int 或可自动拆箱的 Integer，传入 String 或 null 会抛 IllegalFormatConversionException
• 负数也会补零，如 String.format("%03d", -7) 得到 "-07"（符号占一位，实际只补两位）；如果业务上不允许负数，记得提前校验
• 序列号需要持久化（比如存数据库）时，递增逻辑必须线程安全且不重复，不能只依赖本地变量