最可靠的方式是手动拼接时间字符串，即在内容组装开始时调用time.Now().Format("2006-01-02 15:04:05")生成时间戳，逐行写入；避免全局复用同一时间戳、误用String()、忽略Windows文件名限制及高频写入冲突。
写入文件前手动拼接时间字符串最可靠
Go 标准库的 os.WriteFile、io.WriteString 或 *os.File.Write 本身不提供自动插入时间的功能，所谓“自动添加”必须由你显式构造带时间的内容。别指望封装层（比如某些日志库）能替你决定格式和时机——除非你明确用它，否则就是自己拼。
常见错误是试图在打开文件后调用 time.Now() 太晚：比如先 os.OpenFile 再读取旧内容再追加，结果时间戳落在追加动作那一刻，而非逻辑上的“本次写入事件发生时”。应把 time.Now() 放在内容组装的最开始。
- 用
time.Now().Format("2006-01-02 15:04:05")控制格式；注意 Go 的时间格式化魔数不是占位符，而是参考时间"Mon Jan 2 15:04:05 MST 2006"的具体值 - 如果写入的是日志类文本，建议在每行开头加时间戳，而不是只在文件头写一次——后者无法区分多条记录的时序
- 避免用
time.Now().String()：它带时区缩写和微秒，不易解析且长度不固定
追加模式下重复调用 os.OpenFile 要小心时间戳错位
用 os.O_APPEND | os.O_CREATE | os.O_WRONLY 打开文件并反复写入时，每次调用 Write 前都该重新取一次 time.Now()。否则若把时间戳生成提到循环外，所有行会共享同一个时间点，失去时效性。
典型误用：
立即学习“go语言免费学习笔记（深入）”；
ts := time.Now().Format("2006-01-02 15:04:05")
f, _ := os.OpenFile("log.txt", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
for _, msg := range messages {
io.WriteString(f, fmt.Sprintf("[%s] %s\n", ts, msg)) // ❌ 全部用同一个 ts
}
正确做法是把 time.Now() 放进循环内，或封装成函数：
func timestampedLine(msg string) string {
return fmt.Sprintf("[%s] %s\n", time.Now().Format("2006-01-02 15:04:05"), msg)
}
// 然后在循环里用 timestampedLine(msg)
用 log.SetOutput + 自定义 Writer 实现全局时间注入
如果你实际想做的是“所有日志自动带时间”，直接改用 log 包更合适——它原生支持前缀和时间，且线程安全。关键不是“写文件时加时间”，而是“让日志输出管道负责格式化”。
- 调用
log.SetFlags(log.LstdFlags)即可自动添加2006/01/02 15:04:05前缀（注意格式固定，不可自定义） - 若需自定义格式（如去掉日期斜杠、加毫秒），得实现
io.Writer，在Write([]byte)中预处理每一行，再写入文件 - 不要在
Writer.Write里对整块字节流统一加时间戳——日志可能跨行或分多次写入，必须按行切分再处理
Windows 下文件名含时间时注意非法字符
如果时间信息要参与生成文件名（如 report_2024-03-15_14-30-22.txt），- 和 : 在 Windows 中都是合法的，但 : 不行。别用 time.Now().Format("2006-01-02 15:04:05") 直接拼路径——空格和冒号会导致 open /path:with:colon:failed 错误。
安全做法是过滤或替换：
safeName := strings.ReplaceAll(time.Now().Format("2006-01-02_15-04-05"), ":", "-")
filename := fmt.Sprintf("data_%s.json", safeName)
更彻底的方案是用 path.Clean + 白名单替换，但对时间字符串来说，简单替换 : 为 - 已覆盖绝大多数场景。
时间戳精度也容易被忽略：高频写入时用 time.Now() 可能拿到相同纳秒值，导致文件名冲突。真有此风险，就加个原子计数器或用 uuid.NewShort() 辅助去重。
