os.file的write方法默认不是线程安全的；多个goroutine并发调用同一文件对象的write()会导致数据竞争，必须通过互斥锁、通道或sync.once等机制进行显式同步。
os.file的write方法默认不是线程安全的；多个goroutine并发调用同一文件对象的write()会导致数据竞争，必须通过互斥锁、通道或sync.once等机制进行显式同步。
在Go标准库中，线程安全性（更准确地说，是goroutine安全性）遵循明确的默认约定：除非文档明确定义为并发安全，否则任何类型的方法均不保证可被多个goroutine安全调用。os.File 的 Write() 方法正属于此类——其官方文档（pkg.go.dev/os#File.Write）未声明线程安全，因此开发者必须视为非并发安全。
这意味着：若两个或更多 goroutine 同时对同一个 *os.File 实例调用 Write()，即使每次写入内容独立，也存在以下风险：
- 写入字节交错（如 goroutine A 写 "hello"，B 写 "world"，实际文件可能变为 "hweolrllod"）；
- Write() 返回值（写入字节数、错误）不可预测；
- 底层文件偏移量（offset）状态不一致，尤其在非追加模式下表现更明显；
- 触发 go run -race 检测到数据竞争（Data Race）警告。
✅ 正确做法：添加显式同步机制。最常用且推荐的是 sync.Mutex：
package main
import (
"fmt"
"os"
"sync"
)
type SafeWriter struct {
file *os.File
mu sync.Mutex
}
func (sw *SafeWriter) Write(p []byte) (int, error) {
sw.mu.Lock()
defer sw.mu.Unlock()
return sw.file.Write(p)
}
func main() {
f, _ := os.Create("output.txt")
defer f.Close()
writer := &SafeWriter{file: f}
var wg sync.WaitGroup
for i := 0; i < 3; i++ {
wg.Add(1)
go func(id int) {
defer wg.Done()
writer.Write([]byte(fmt.Sprintf("Goroutine %d\n", id)))
}(i)
}
wg.Wait()
}⚠️ 注意事项：
立即学习“go语言免费学习笔记（深入）”；
- os.OpenFile(..., os.O_APPEND, ...) 模式下，Linux/macOS 系统调用 write() 本身在追加模式具有原子性（内核保证写入位置自动定位到文件末尾），但这不等于 Go 层 Write() 方法线程安全——仍需同步，因为 Write() 前的长度计算、切片处理等步骤不在原子范围内；
- 使用 log.Logger 并设置 Output 为 *os.File 是安全的，因为 log 包内部已使用 mu.Lock() 封装了写操作；
- 若需高性能并发日志，建议直接使用成熟库（如 zap 或 zerolog），它们内置无锁缓冲与批量刷盘机制。
总结：Go 的设计哲学是“显式优于隐式”。os.File.Write() 不提供开箱即用的并发安全，恰恰是为了避免隐藏的性能开销与误用假设。开发者应主动识别共享资源，以最小粒度加锁（如封装 SafeWriter），并始终启用 -race 进行竞态检测——这是构建健壮并发程序的基石实践。
