C++里想“体面地”输出货币？别只盯着printf，put_money才是藏在<locale>里的老派绅士

你有没有试过这样写：

double price = 1234.56;
std::cout << "$" << std::fixed << std::setprecision(2) << price;

看着挺顺，但一换到德国用户机器上，输出变成 $1234.56 —— 而人家期待的是 1.234,56 €；或者在日本环境里，你硬塞的 $ 符号直接被当成乱码。这不是代码错了，是你的输出逻辑没真正“入境”。

C++ 标准库里其实早备好了一位本地化货币输出的“礼宾员”：std::put_money。它不拼格式字符串，不手动插千位分隔符，也不靠预设符号硬编码——它读取当前 locale 的货币规则，自动决定：钱该放左边还是右边、小数点是点还是逗号、要不要千位分隔、负数怎么标（括号？减号？前缀负号？）。

可奇怪的是，网上搜“C++ 货币格式”，十篇有九篇教你用 sprintf 或 std::format（C++20），剩下那篇提了 put_money，却只给一行示例，连 imbue 都没配全，跑起来直接输出一串看不懂的数字。

我们来把它真正用起来。

std::put_money 不是独立函数，它是 std::money_put facet 的封装，必须依附于一个带货币 locale 的 std::ostream。关键一步：流必须先 imbue 一个支持货币的本地环境。

比如你想按美国习惯输出：

#include <iostream>
#include <locale>
#include <iomanip>

int main() {
    std::cout.imbue(std::locale("en_US.UTF-8")); // 关键！必须指定带货币信息的 locale
    long double amount = 123456; // 注意：单位是“最小货币单位”，即美分 → 1234.56 美元
    std::cout << std::showbase << std::put_money(amount) << '\n';
    // 输出：$1,234.56
}

这里有两个易踩的坑，得拎清楚：

• 输入值必须是整数型（long double 或 long long），且以“最小货币单位”为基准。不是 1234.56，而是 123456（美分）、12345600（日元，因日元无小数位，但接口仍要求整数）。这是为了规避浮点精度导致的 0.1 + 0.2 != 0.3 类问题——货币计算本就不该用浮点。
• std::showbase 必须开启，否则 $、€ 这类货币符号不会出现。它不是可选项，是开关。

再试试欧洲风格：

std::cout.imbue(std::locale("de_DE.UTF-8"));
std::cout << std::showbase << std::put_money(123456LL) << '\n';
// 输出：1.234,56 €

看到没？符号自动跑到右边，千位用点，小数用逗号——没改一行逻辑，只换了 locale，输出就“入乡随俗”。

那如果系统没装 de_DE.UTF-8 怎么办？别急，C++ 允许 fallback：

try {
    std::cout.imbue(std::locale("zh_CN.UTF-8"));
} catch (const std::runtime_error&) {
    std::cout.imbue(std::locale("")); // 使用系统默认 locale
}

更稳妥的做法，是把 locale 初始化封装成工具函数，避免每次重复 try-catch。

还有一点常被忽略：put_money 默认使用 long double，但如果你传 int 或 long long，它会隐式转换——只要值在 long double 精度范围内（通常远超日常货币需求），完全安全。不必强转，反而增加出错可能。

实际项目中，建议封装一层：

std::string format_currency(long long cents, const std::string& loc_name = "") {
    std::ostringstream oss;
    try {
        oss.imbue(loc_name.empty() ? std::locale("") : std::locale(loc_name));
    } catch (...) {
        oss.imbue(std::locale("C")); // 最小保障
    }
    oss << std::showbase << std::put_money(cents);
    return oss.str();
}

调用时干净利落：format_currency(123456, "en_US.UTF-8") → "$1,234.56"。

最后说个现实提醒：Windows 控制台对 UTF-8 locale 支持较弱，"zh_CN.UTF-8" 可能失败，此时可用 "Chinese_China.936"（GBK）替代；Linux/macOS 则基本无压力。跨平台时，locale 名字不是写死的配置项，而是需要运行时探测+降级的活策略。

put_money 不是炫技工具，它是 C++ 对“本地化”这件事认真的证明。它不替你做四则运算，不帮你存数据库，但它确保当用户看到价格时，第一反应是“这钱我认得”，而不是“这啥玩意儿”。

下次再为货币格式焦头烂额，不妨放下 std::fixed << std::setprecision(2)，花两分钟配好 locale，让 put_money 把剩下的体面，悄悄做完。