C++ 中 ofstream 文件写入操作详解：从入门到规范实践

在 C++ 标准库中，std::ofstream（output file stream）是进行文件输出操作最常用、最安全的工具之一。它封装了底层系统调用，提供面向对象的接口，支持格式化写入、异常处理与流状态检查，是替代 C 风格 fprintf() 的现代首选。

一、基础使用：三步完成写入

#include <fstream>
#include <iostream>

int main() {
    std::ofstream ofs("data.txt");  // ① 构造并打开文件（默认 ios::out | ios::trunc）
    if (!ofs.is_open()) {           // ② 检查是否成功打开
        std::cerr << "无法创建或打开文件！\n";
        return -1;
    }
    ofs << "Hello, C++!" << std::endl  // ③ 写入内容（支持流式操作）
        << 42 << " " << 3.14159;
    ofs.close();  // 可选：析构函数会自动关闭，显式调用更清晰
}

✅ 默认行为：以 trunc 模式打开 → 若文件存在则清空重写；若需追加，请显式指定 std::ios::app。

二、关键构造与打开模式

⚠️ 注意：app 与 trunc 互斥；in 和 out 不能同时用于 ofstream（应改用 fstream）。

三、错误处理与状态检查（生产必备）

不要仅依赖 is_open()！建议结合 fail()、bad() 与 clear()：

ofs << "Some data";
if (ofs.fail()) {
    std::cerr << "写入失败（磁盘满/权限不足等）\n";
    ofs.clear(); // 清除错误标志，避免后续操作失效
}

• fail()：格式错误或写入失败（最常用）
• bad()：底层 I/O 错误（如硬件故障）
• good()：一切正常

四、最佳实践小贴士

• ✅ RAII 安全：ofstream 对象离开作用域时自动析构并关闭文件，无需手动 close()（但显式调用利于调试）
• ✅ 中文支持：Windows 下需 ofs.imbue(std::locale(".UTF8")) 或使用 std::codecvt_utf8（C++17 起推荐 std::filesystem + UTF-8 路径）
• ⚠️ 路径注意：相对路径基于当前工作目录（非源码目录），建议用绝对路径或 std::filesystem::current_path() 辅助调试
• 🌟 性能提示：高频小写入可搭配 rdbuf()->pubsetbuf() 设置缓冲区（一般无需）

掌握 ofstream，你已迈出 C++ 文件 I/O 稳健开发的第一步。记住：打开要检查，写入要验证，关闭靠析构，编码讲规范——这才是工业级代码的底气。