Golang如何使用ioutil.WriteFile写入文件_Golang WriteFile文件写入实践-Golang-PHP中文网

Golang如何使用ioutil.WriteFile写入文件_Golang WriteFile文件写入实践

P粉602998670

发布： 2025-11-26 19:01:26

原创

748人浏览过

ioutil.WriteFile用于一次性写入文件，参数包括路径、字节切片和权限，支持字符串、JSON等数据类型转换后写入，但会覆盖原文件，不适用于大文件或追加场景，Go 1.16起推荐使用os.WriteFile替代。

golang如何使用ioutil.writefile写入文件_golang writefile文件写入实践

在Go语言中，ioutil.WriteFile 是一种快速、简洁的文件写入方式，适用于将数据一次性写入文件的场景。虽然从Go 1.16开始，ioutil.WriteFile 被归入废弃状态（建议使用 os.WriteFile），但其用法依然广泛存在于现有项目中。本文以实践角度说明如何正确使用该函数进行文件写入。

函数签名与参数说明

ioutil.WriteFile 的函数原型如下：

func WriteFile(filename string, data []byte, perm fs.FileMode) error

三个参数分别表示：

filename：目标文件路径，字符串类型
data：要写入的数据，必须是字节切片（[]byte）
perm：文件权限，如 0644、0755 等

该函数会自动创建文件（如果不存在），若文件已存在则覆盖原内容。

立即学习“go语言免费学习笔记（深入）”；

基本写入示例

以下是一个将字符串写入文本文件的简单例子：

package main

import (
  "io/ioutil"
)

func main() {
  content := "Hello, Golang!"
  err := ioutil.WriteFile("output.txt", []byte(content), 0644)
  if err != nil {
    panic(err)
  }
}

执行后会在当前目录生成 output.txt，内容为 "Hello, Golang!"，权限设置为 0644（即所有者可读写，其他用户只读）。

知海图Chat

知乎与面壁智能合作推出的智能对话助手

157

查看详情

处理不同数据类型

由于 WriteFile 接收的是字节切片，因此需要将其他类型转换为 []byte：

字符串 → []byte(str)
结构体 → 先用 json.Marshal 转为 JSON 字符串再转字节
整数等基础类型 → 使用 strconv 或 fmt.Sprint 转为字符串再转字节

例如写入 JSON 数据：

type User struct {
Name string `json:"name"`
Age int `json:"age"`
}

user := User{Name: "Alice", Age: 25}
data, _ := json.Marshal(user)
ioutil.WriteFile("user.json", data, 0644)