最稳妥方式是用 bufio.Writer 配合 WriteString 和 WriteRune('\n');需显式写换行符、设合适缓冲区、追加用 os.O_APPEND、写完必 Flush,避免 fmt.Fprintln 的无缓冲与隐式行为。

用 bufio.Writer 配合 WriteString 和 WriteRune('\n') 最稳妥
Go 没有内置“按行写入”的原子函数,fmt.Fprintln 虽然方便,但底层每次调用都可能触发一次系统 write,频繁写小行时性能差、还容易被中断。真正可控的方式是用 bufio.Writer 缓冲输出,手动控制换行。
关键点:换行符必须显式写入,不能依赖 WriteString 自带——它只写你给的字符串,不加 \n。
- 先用
os.OpenFile以os.O_CREATE | os.O_WRONLY | os.O_APPEND模式打开文件(追加)或os.O_TRUNC(覆盖) - 包一层
bufio.NewWriter,缓冲区大小建议设为 4096(默认值通常够用) - 每行数据调用
wr.WriteString(line)+wr.WriteRune('\n'),比wr.WriteString(line + "\n")少一次字符串拼接 - 写完必须调用
wr.Flush(),否则缓冲区内容可能滞留内存中不落盘
fmt.Fprintln 能用,但要注意它的三个隐含行为
它确实“看起来”是按行写,但实际行为常被忽略:
- 会在参数末尾自动加
\n,但不会帮你处理参数里的换行符——如果line本身含\n,会写出多行,不是你想要的“一行一调用” - 底层直接调用
io.WriteString+io.WriteString写\n,无缓冲,高频率写入时 syscall 开销明显 - 返回的
error是写入过程错误,但不包含Flush失败——如果用在bufio.Writer上套fmt.Fprintln,仍需额外Flush
适合调试打印、日志量小、或一次性写入少量行的场景;生产环境高频写入请绕开它。
追加写入时,os.O_APPEND 和自己 Seek 的区别
很多人以为“打开文件后 Seek(0, io.SeekEnd) 再写”等价于 os.O_APPEND,其实不是:
-
os.O_APPEND是内核级原子操作:每次write系统调用前,内核自动把文件偏移移到末尾,多进程/多 goroutine 并发追加也不会覆盖 - 手动
Seek+Write是两步:先定位、再写入,中间可能被其他写入抢占,导致错位 - 所以追加场景务必用
os.O_APPEND,别自己算位置
Windows 下换行符要留意 \r\n 还是 \n
Go 标准库所有 I/O 操作(包括 fmt.Fprintln、bufio.Writer)一律使用 \n。它不会根据 OS 自动转 \r\n。
这意味着:
- 在 Windows 上用记事本打开文件,如果只写
\n,可能显示为“所有文字挤在一行”(记事本老版本不识别\n) - 解决方案不是改 Go 代码,而是确保目标程序兼容 LF 换行(如 VS Code、Notepad++、现代记事本都支持),或写入前手动替换:
strings.ReplaceAll(line, "\n", "\r\n") - 跨平台分发文本文件时,换行符统一用
\n是更通用的选择
真正容易被忽略的是 Flush 的时机和 Append 的原子性——这两点出问题,要么丢数据,要么文件损坏,比换行符问题严重得多。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











