C++ std::print直接格式化输出替代cout的新方式

std::cout 虽然是 C++ 标准库的标配，但在日常开发中常被诟病语法繁琐、性能一般。C++23 引入了全新的 <print> 头文件，提供了 std::print 和 std::println。这种方式不仅语法接近 Python 的 f-string，性能也远超传统的流式输出。

以下指南将手把手带你完成从 std::cout 到 std::print 的迁移与使用。

准备工作：确认编译环境

由于 std::print 是 C++23 的特性，你需要确保使用的编译器和标准库版本已支持该特性。

检查 你的编译器版本是否满足以下要求：

• GCC：版本需 ≥ 14
• Clang：版本需 ≥ 18（需链接 -lc++）
• MSVC (Visual Studio)：版本需 ≥ 19.40 (Visual Studio 2022 17.10)

配置 你的编译参数，确保开启 C++23 标准。例如在 GCC 或 Clang 中，添加 -std=c++23 参数。

基础用法：替换简单的输出

使用 std::print 最直接的好处是省去了繁琐的 << 运算符重载。

1. 包含 头文件 <print>。
2. 使用 双花括号 {} 作为占位符。
3. 传入 需要格式化的变量。

对比 以下两段代码：

使用 std::cout 的传统写法：

#include <iostream>
#include <string>

int main() {
    std::string name = "C++";
    int version = 23;
    std::cout << "Hello " << name << ", version " << version << "!" << std::endl;
    return 0;
}

使用 std::print 的新写法：

#include <print>
#include <string>

int main() {
    std::string name = "C++";
    int version = 23;
    std::print("Hello {}, version {}!\n", name, version);
    return 0;
}

在 std::print 中，{} 会自动按顺序替换为后续的参数。

进阶用法：格式化占位符

std::print 支持类似 Python 的格式化说明符，可以轻松控制浮点数精度、进制转换等。

语法格式为：{:格式化选项}。

参考 常用的格式化选项表：

练习 编写一段代码格式化输出数字：

#include <print>

int main() {
    double pi = 3.1415926;
    int value = 255;

    // 输出: Pi ≈ 3.14 (Hex: 0xff)
    std::print("Pi ≈ {:.2f} (Hex: {:#x})", pi, value);
    return 0;
}

自动换行：使用 println

在旧代码中，每次输出换行都需要手动输入 std::endl 或 "\n"。std::print 提供了一个自动换行的变体。

使用 std::println 替代在字符串末尾手动添加 \n。

#include <print>

int main() {
    // 以下两行代码效果完全一致
    std::print("Hello World\n");
    std::println("Hello World");
    return 0;
}

输出到文件与流

除了控制台，std::print 还支持直接输出到 FILE* 指针，这在处理日志文件时比 ofstream 更加轻量。

1. 获取 文件的 FILE* 指针（使用 C 标准库的 fopen 或 C++ 的 _fdopen）。
2. 调用 std::print 的第一个参数传入文件指针。

示例 写入日志文件：

#include <print>
#include <cstdio>

int main() {
    // 打开文件，"w" 表示写入模式
    FILE* log_file = std::fopen("log.txt", "w");

    if (log_file) {
        // 将内容直接格式化写入文件
        std::print(log_file, "[Error] Code: {}, Message: {}\n", 404, "Not Found");

        // 关闭文件
        std::fclose(log_file);
    }
    return 0;
}

编译与运行示例

为了确保代码能正确运行，请按照以下步骤操作。

1. 创建 一个名为 main.cpp 的文件，输入以下完整代码：

#include <print>
#include <vector>

int main() {
    // 基础输出
    std::println("--- System Check ---");

    // 格式化输出
    int cpu_load = 85;
    double temp = 45.6;
    std::print("CPU Load: {}%, Temp: {:.1f}C\n", cpu_load, temp);

    // 容器输出（需遍历，std::print 不支持直接打印 vector）
    std::vector<int> ids = {101, 102, 103};
    std::print("IDs: ");
    for (const auto& id : ids) {
        std::print("{} ", id);
    }
    std::println(""); // 换行

    return 0;
}

2. 执行 编译命令（以 GCC 14 为例）：

g++ -std=c++23 main.cpp -o app

3. 运行 生成的可执行文件：

./app

预期 终端输出如下：

--- System Check ---
CPU Load: 85%, Temp: 45.6C
IDs: 101 102 103 

常见问题处理

编译错误：'print' is not a member of 'std'

这通常意味着链接了旧版的标准库或者 GCC 版本虽然够高但 libstdc++ 没有更新。

检查 GCC 版本：

g++ --version

确认 编译命令是否正确包含了 -std=c++23。

中文乱码问题

Windows 控制台默认编码可能导致 std::print 输出中文乱码（因为它直接操作 UTF-8 字节流）。

执行 以下代码在程序开始前设置控制台编码为 UTF-8（Windows 特有）：

#include <windows.h>
#include <print>

int main() {
    // 将控制台输出页设置为 UTF-8
    SetConsoleOutputCP(CP_UTF8);

    std::println("测试中文输出");
    return 0;
}