14、输入输出流与序列化：iostream体系、文件流操作、stringstream应用、自定义序列化方案

说实话，C++的输入输出流（iostream）是我刚入行时觉得最“啰嗦”的部分。那时候我更喜欢用printf，觉得它简洁直接。直到我在一个大型项目中接手了一个遗留系统，里面全是C风格的I/O，调试起来简直噩梦——类型不匹配、缓冲区溢出、格式化字符串漏洞……嗯，从那以后，我彻底倒向了iostream。

这一章，我们就来聊聊iostream体系、文件流、stringstream，以及如何设计一套靠谱的自定义序列化方案。这些东西，说白了就是C++程序与外界打交道的“嘴巴”和“耳朵”。

14.1 iostream体系：不只是cin和cout

iostream体系的核心，是三个类族：istream（输入）、ostream（输出）、iostream（双向）。它们通过继承和模板，构成了一个灵活的类型安全I/O框架。

我个人习惯把iostream看作一个“管道系统”：数据从源头（键盘、文件、内存字符串）流入，经过格式化处理，最终到达目的地。每个流对象内部都有一个缓冲区（streambuf），负责实际的读写操作。

流状态是另一个容易忽略的点。每个流都有四个状态位：goodbit、eofbit、failbit、badbit。我建议每次读取后都检查状态，否则你可能读到一堆垃圾数据而不自知。

// 流状态检查示例
std::ifstream file("data.bin");
int value;
if (file >> value) {
    // 读取成功
} else if (file.eof()) {
    // 文件结束，但可能还有数据没读
} else if (file.fail()) {
    // 格式错误，比如读到非数字字符
} else if (file.bad()) {
    // 严重错误，比如磁盘损坏
}

14.2 文件流操作：读写、定位与错误处理

文件流是iostream体系中最常用的部分。你想想看，几乎每个需要持久化的程序都离不开文件读写。C++提供了三种文件流：ifstream（读）、ofstream（写）、fstream（读写）。

打开模式：

模式	含义	常用场景
ios::in	读模式	ifstream默认
ios::out	写模式（清空原内容）	ofstream默认
ios::app	追加模式	日志文件
ios::binary	二进制模式	非文本文件
ios::ate	打开后定位到文件尾	需要知道文件大小
ios::trunc	打开时清空文件	覆盖写入

我记得有一次，一个同事用文本模式写了一个图片文件，结果图片打不开。原因很简单：在Windows下，文本模式会把\n自动转换成\r\n，二进制数据就被破坏了。所以，处理非文本文件时，一定要加上ios::binary。

// 二进制文件读写示例
struct Header {
    uint32_t magic;
    uint32_t version;
    uint64_t dataSize;
};

// 写入
Header h{0xDEADBEEF, 1, 1024};
std::ofstream ofs("data.bin", std::ios::binary);
ofs.write(reinterpret_cast<const char*>(&h), sizeof(h));

// 读取
Header h2;
std::ifstream ifs("data.bin", std::ios::binary);
ifs.read(reinterpret_cast<char*>(&h2), sizeof(h2));
if (ifs.gcount() != sizeof(h2)) {
    // 处理读取不完整的情况
}

文件定位也是常见操作。使用tellg()/tellp()获取当前位置，seekg()/seekp()移动位置。我个人习惯在读取复杂格式文件时，先用tellg()记录关键位置，方便回溯。

14.3 stringstream应用：内存中的格式化利器

stringstream是我在项目中用得最多的流类型。它把字符串当作流来操作，特别适合做数据格式转换、拼接和解析。

典型应用场景：

• 数字与字符串互转（比sprintf安全）
• 复杂字符串拼接（比+操作符高效）
• 解析CSV、配置文件等结构化文本
• 日志格式化输出

// stringstream典型用法
std::stringstream ss;

// 1. 格式化拼接
ss << "User: " << username
   << ", Score: " << score
   << ", Level: " << level;
std::string log = ss.str();

// 2. 解析CSV行
std::string line = "Alice,85,3";
ss.str(line);
std::string name;
int score;
int level;
char comma;
ss >> name >> comma >> score >> comma >> level;

// 3. 清空复用
ss.str("");  // 清空内容
ss.clear();  // 重置状态

stringstream还有一个妙用：做内存中的“临时文件”。比如，你需要测试一个解析函数，但又不想创建真实文件，就可以把测试数据写入stringstream，然后传给解析函数。这样既快又干净。

14.4 自定义序列化方案：从简单到工业级

序列化，说白了就是把内存中的对象变成字节流，方便存储或传输。反序列化就是逆过程。C++标准库没有内置序列化机制，所以我们需要自己设计。

我参与过一个游戏引擎项目，里面有一套完整的序列化系统。最初我们用的是protobuf，但后来发现对于频繁变动的游戏数据结构，protobuf的代码生成太笨重了。于是我们自己写了一套轻量级方案。

一个简单的序列化框架：

// 序列化接口
class Serializable {
public:
    virtual void serialize(std::ostream& os) const = 0;
    virtual void deserialize(std::istream& is) = 0;
    virtual ~Serializable() = default;
};

// 具体实现
class Player : public Serializable {
    std::string name_;
    int level_;
    float hp_;
    
public:
    void serialize(std::ostream& os) const override {
        // 先写长度，再写字符串内容
        uint32_t len = name_.size();
        os.write(reinterpret_cast<const char*>(&len), sizeof(len));
        os.write(name_.data(), len);
        
        os.write(reinterpret_cast<const char*>(&level_), sizeof(level_));
        os.write(reinterpret_cast<const char*>(&hp_), sizeof(hp_));
    }
    
    void deserialize(std::istream& is) override {
        uint32_t len;
        is.read(reinterpret_cast<char*>(&len), sizeof(len));
        name_.resize(len);
        is.read(&name_[0], len);
        
        is.read(reinterpret_cast<char*>(&level_), sizeof(level_));
        is.read(reinterpret_cast<char*>(&hp_), sizeof(hp_));
    }
};

我曾经踩过一个坑：在32位和64位系统之间传输序列化数据，结果size_t的大小不同，导致数据错位。从那以后，我所有序列化字段都使用固定宽度类型（uint32_t、int64_t等）。

对于工业级项目，我建议考虑以下方案：

• protobuf：Google出品，跨语言，适合微服务
• Cap'n Proto：零拷贝，性能极高
• Boost.Serialization：功能全面，但依赖Boost
• cereal：轻量级，header-only，C++11友好

但如果你需要完全控制序列化格式（比如为了兼容旧系统），自己写一套也不难。关键是设计好接口，保持扩展性。

最后说一句：序列化方案没有银弹。选择哪种方案，取决于你的项目需求——数据量大小、跨语言需求、性能要求、团队熟悉度。我个人倾向于在项目初期就定好序列化方案，因为后期替换成本极高。

---

公众号:蓝海资料掘金营，微信deep3321