如何实现Formattable接口来自定义变量对象的格式化输出策略？

本文共计896个文字，预计阅读时间需要4分钟。

要让自定义对象支持灵活、可控，需要确保以下要点：

Java 中的 Formattable 接口：配合 printf 精确控制输出样式

Java 的 java.util.Formattable 接口要求实现 formatTo(Formatter, int, int, int) 方法，它不返回字符串，而是直接向 Formatter 写入格式化后的内容。这种方式更底层，也更高效。

• 标志位驱动行为：通过 flags 参数可识别 FormattableFlags.ALTERNATE（如 %#s）、UPPERCASE（如 %S）等，实现同一对象不同风格输出
• 宽度与精度由调用方指定：width 控制最小占位宽度，precision 控制字符截断或小数位数，无需在类里硬编码
• 必须配合 printf 或 Formatter.format 使用：直接调用 toString() 不会触发该逻辑

C# 中的 IFormattable 接口：支持文化感知与格式字符串解析

C# 的 IFormattable 更侧重声明式约定，其 ToString(string format, IFormatProvider provider) 方法接收两个关键参数：格式说明符（如 "F2"、"C"）和格式提供者（如 CultureInfo.GetCultureInfo("de-DE")）。

• 格式字符串可自定义：不限于系统内置的 C/D/F/N，比如温度类支持 "C"（摄氏）、"F"（华氏）、"K"（开尔文）
• 文化信息真正起作用：传入不同 IFormatProvider，数字分隔符、货币符号、日期顺序会自动适配，无需手动判断语言环境
• 兼容所有格式化入口：不仅 string.Format 和 Console.WriteLine 能用，字符串插值 $"{obj:F2}" 同样生效

为什么不能只靠重写 ToString()？

单纯重写无参 ToString() 是静态、单一的——它只能返回一种固定格式，无法响应外部对精度、单位、大小写、本地化等需求。而 Formattable 或 IFormattable 提供的是“按需生成”，把控制权交还给使用者。

• 比如一个 Vector 类，可能需要 "N" 显示模长、"VE" 显示科学计数法分量、"IJK" 显示单位向量形式——单个 ToString() 无法同时满足
• 再如用户姓名类，在英文界面输出 "John Smith"，在德语界面可能需输出 "Smith, John"，这依赖 formatProvider 而非硬编码逻辑

实际使用时的关键注意点

接口本身只是契约，真正发挥价值依赖调用方式和上下文。

• Java：确保用 System.out.printf("%s", obj)，而不是 System.out.println(obj)；%s 才会触发 formatTo，println 只走 toString()
• C#：显式传入格式字符串才有意义，obj.ToString() 或 $"{obj}" 仍调用默认实现；若想统一行为，可在 ToString(string, IFormatProvider) 中对 format == null 做降级处理
• 避免空指针：formatProvider 可为 null，应使用 FormatProvider.CurrentInfo 或 CultureInfo.CurrentCulture 安全兜底