直接构造 ofstream 对象并传入文件路径即可打开或创建文件;调用

用 ofstream 写入文本文件的基本写法
直接构造 ofstream 对象并传入文件路径,就能打开(或创建)文件;调用 操作符写入字符串或基本类型即可。默认以文本模式打开,换行符会自动转换为平台原生格式(如 Windows 下转 <code>\r\n)。
常见错误是忽略打开失败检查——路径不存在、权限不足、文件被占用都会导致 ofstream 构造后 is_open() 返回 false,但不抛异常。
- 写入前务必检查:
if (!file.is_open()) { /* 处理错误 */ } - 路径支持相对路径(如
"data/output.txt")和绝对路径(如"C:/temp/log.txt") - 若文件已存在,默认覆盖内容;如需追加,得显式指定
ios::app模式
ofstream 的打开模式怎么选:覆盖 vs 追加
默认构造等价于 ios::out,会清空已有文件内容。要追加写入,必须手动传入 ios::app,且不能同时用 ios::out | ios::app 简单拼接——ios::app 本身就隐含了输出行为,且强制将写位置移到文件末尾。
注意:ios::app 模式下,每次写入前都会重新定位到末尾,即使你中途调用 seekp() 也无效。
- 覆盖写入:
ofstream file("log.txt");或ofstream file("log.txt", ios::out); - 追加写入:
ofstream file("log.txt", ios::app); - 想先读再写?
ofstream不支持读操作,得换fstream并配ios::in | ios::out
中文乱码问题:ofstream 不处理编码,别指望它自动转 UTF-8
ofstream 是字节流,它只负责把内存里的 char 或 std::string 原样写入文件。如果你的源文件保存为 UTF-8,字符串字面量含中文,那写进去的就是 UTF-8 字节;但如果终端或编辑器默认用 GBK 解析,就会显示乱码。
没有跨平台的“自动编码转换”机制。Windows 上常见做法是用 std::locale 绑定带代码页的 facet(如 std::codecvt_utf8),但 C++20 已弃用 codecvt;更实际的方案是:确保源码保存为 UTF-8 + BOM(部分 Windows 编辑器需要),或手动用 std::wstring_convert(C++17 前)/ 第三方库(如 ICU、utf8cpp)做转换。
- 简单测试是否真乱码:用 VS Code 或 Notepad++ 手动切换编码查看效果
- 避免踩坑:不要在字符串字面量里硬写中文,改用 Unicode 转义(如
"\u4f60\u597d")或外部资源文件 - Linux/macOS 下通常默认 UTF-8,问题较少;Windows 控制台默认活动代码页(如 936),需用
SetConsoleOutputCP(CP_UTF8)配合
写完记得 close()?其实多数情况不用,但异常路径必须小心
ofstream 析构时会自动调用 close(),所以局部对象离开作用域即安全关闭。但如果你用 new 动态分配,或者函数中途 return、抛异常,就可能跳过析构——此时缓冲区内容可能未落盘。
更隐蔽的问题是:写入失败(如磁盘满)不会立即报错,operator 只设置流状态位(<code>failbit),需主动检查 file.good() 或 !file.fail()。
- 推荐写法:
ofstream file("a.txt"); if (!file) return; file - 动态分配时,用智能指针或确保
close()在catch块中执行 - 频繁小写入性能差?可调用
file.rdbuf()->pubsetbuf(buf, size)设置缓冲区(但标准库不保证生效)
实际项目里最常漏掉的是打开失败检查和写入后状态校验——尤其当文件路径来自用户输入或配置时,这两个点一错,程序就静默丢数据。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











