Go语言正确写入CRLF换行符方法

本文深入解析了Go语言在Windows环境下因默认使用LF（\n）换行符而导致文件在记事本中显示为单行的常见痛点，明确指出问题根源在于记事本严格依赖CRLF（\r\n）作为唯一识别的换行序列，并提供了直接有效的解决方案——显式写入\r\n，同时补充了跨平台适配、性能优化（如结合bufio.Writer）及常见误区澄清（如fmt.Fprintln不会自动转换），帮助开发者以零成本、高可靠性确保文本文件在Windows基础环境中正确换行，特别适合面向终端用户或需兼容遗留系统的生产场景。

在Windows系统中，记事本仅识别CRLF（\r\n）作为换行符，而Go默认使用LF（\n）；若未显式写入\r\n，文件在记事本中将显示为无换行的连续文本。本文详解原因、修复方法及跨平台最佳实践。

在Windows系统中，记事本仅识别CRLF（\r\n）作为换行符，而Go默认使用LF（\n）；若未显式写入\r\n，文件在记事本中将显示为无换行的连续文本。本文详解原因、修复方法及跨平台最佳实践。

Windows记事本（Notepad.exe）严格遵循传统DOS/Windows文本格式规范：换行必须由回车符（CR, \r）和换行符（LF, \n）组成的序列 \r\n 表示。相比之下，Unix/Linux/macOS系统仅使用单个LF（\n）作为行结束符。Go语言的io.WriteString等I/O函数本身是平台无关的，它忠实输出你传入的字节——因此当你写入"Hello World\n"时，Go确实写入了LF，但记事本无法将其识别为有效换行，导致多行内容“粘连”显示（如 Hello WorldGoodbye）。

✅ 正确写法：显式使用 \r\n

最直接的修复方式是将换行符替换为Windows兼容的CRLF：

f, err := os.Create("/dir/File_" + t.Format("20060102") + ".txt")
if err != nil {
    log.Fatal(err)
}
defer f.Close()

n, err := io.WriteString(f, "Hello World\r\n")
if err != nil {
    log.Fatal(err)
}
n, err = io.WriteString(f, "Goodbye\r\n")
if err != nil {
    log.Fatal(err)
}

执行后，该文件在Windows记事本中将正确显示为两行：

Hello World
Goodbye

⚠️ 注意事项与进阶建议

• 不要依赖fmt.Fprintln自动适配：fmt.Fprintln在Windows下仍只输出\n（Go标准库未对终端/文件做CRLF转换），因此fmt.Fprintln(f, "Hello") 与 io.WriteString(f, "Hello\n") 行为一致，无法解决记事本兼容问题。

• 跨平台健壮性方案：若程序需同时支持多平台，推荐使用runtime.GOOS动态选择换行符，或更优地——统一使用fmt.Fprintln + 外部工具处理（见下文）。例如：

  import "runtime"
  
  var lineEnd string
  if runtime.GOOS == "windows" {
      lineEnd = "\r\n"
  } else {
      lineEnd = "\n"
  }
  io.WriteString(f, "Hello World"+lineEnd)

• 生产环境推荐：用bufio.Writer提升性能
  频繁调用io.WriteString会产生多次系统调用。结合换行符处理，建议封装为可复用的写入器：

  writer := bufio.NewWriter(f)
  defer writer.Flush()
  
  writeLine := func(s string) {
      writer.WriteString(s)
      writer.WriteString("\r\n") // Windows-safe
  }
  writeLine("Hello World")
  writeLine("Goodbye")

• 终极提醒：文件编码与BOM无关
  此问题与UTF-8 BOM、ANSI编码等无关，纯属行结束符（EOL）标准差异。即使文件保存为UTF-8无BOM，只要含\r\n，记事本即可正常换行。

总结

根本原因在于Windows记事本的换行符契约是\r\n，而非\n。在Go中写入文本文件供Windows记事本查看时，必须显式使用\r\n。虽然WordPad、VS Code、Notepad++等现代编辑器能智能识别多种换行符，但面向基础用户或遗留系统时，主动适配\r\n是简单、可靠且零成本的最佳实践。

今天关于《Go语言正确写入CRLF换行符方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！