如何在 Go 语言中将格式化输出写入文件-Golang-PHP中文网

本文详解如何使用 fmt.fprintf 结合文件句柄，将 go 程序中的格式化结果（如切片、数值等）持久化写入文本文件，并提供完整可运行示例、错误处理建议及性能优化要点。

本文详解如何使用 fmt.fprintf 结合文件句柄，将 go 程序中的格式化结果（如切片、数值等）持久化写入文本文件，并提供完整可运行示例、错误处理建议及性能优化要点。

在 Go 中，fmt.Printf 默认输出到标准输出（os.Stdout），但若需将格式化内容直接写入文件，应使用 fmt.Fprintf —— 它接受任意实现了 io.Writer 接口的对象（如 *os.File 或带缓冲的 *bufio.Writer）作为第一个参数，从而实现定向输出。

以下是一个生产就绪的示例代码，它生成随机排列、按需格式化输出，并安全写入文件：

package main

import (
    "bufio"
    "fmt"
    "os"
    "math/rand"
    "time"
)

func main() {
    // 创建输出文件（若存在则清空）
    f, err := os.Create("output.txt")
    if err != nil {
        fmt.Fprintf(os.Stderr, "创建文件失败: %v\n", err)
        return
    }
    defer f.Close()

    // 使用 bufio.Writer 提升小量写入性能（减少系统调用）
    writer := bufio.NewWriter(f)
    defer writer.Flush() // 确保所有缓存数据写入文件

    // 生成随机排列
    r := rand.New(rand.NewSource(time.Now().UnixNano()))
    perm := r.Perm(5) // 返回 [0,1,2,3,4] 的随机重排，长度为 5

    // 格式化写入文件（注意：Fprintf 返回 (n int, err error)，需检查）
    if _, err := fmt.Fprintf(writer, "%v\n", perm); err != nil {
        fmt.Fprintf(os.Stderr, "写入切片失败: %v\n", err)
        return
    }
    if _, err := fmt.Fprintf(writer, "%d\n", perm[0]); err != nil {
        fmt.Fprintf(os.Stderr, "写入首元素失败: %v\n", err)
        return
    }
    if _, err := fmt.Fprintf(writer, "%d\n", perm[1]); err != nil {
        fmt.Fprintf(os.Stderr, "写入次元素失败: %v\n", err)
        return
    }

    fmt.Println("结果已成功写入 output.txt")
}

✅ 关键要点说明：

使用Go语言搭建家庭相册系统-相关课件

下载

os.Create 会创建新文件或截断已有文件，适合覆盖写入；若需追加，请改用 os.OpenFile(..., os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)。
bufio.NewWriter 显著提升频繁小写入的效率，但务必调用 Flush()（此处用 defer 保证执行）。
错误处理 应避免 panic，推荐显式判断并记录日志或返回错误，以保障程序健壮性。
fmt.Fprintf 是最直接的“带格式的文件写入”方案；其他方式（如 f.WriteString、json.Encoder、io.WriteString）适用于无格式纯文本或结构化场景。

运行后，output.txt 将包含类似内容：