登录
首页 >  Golang >  Go教程

Golangioutil写入文件方法详解

时间：2026-03-27 17:16:37 470浏览 收藏

本文详解了 Go 语言中文件写入的演进路径：从早期广泛使用的 ioutil.WriteFile（支持文本与二进制数据、无需手动管理文件句柄）出发，通过简洁示例展示了如何写入字符串和复制图片等典型场景；同时明确指出——自 Go 1.16 起该函数已被官方废弃，推荐直接采用功能一致、更轻量且无需额外包的 os.WriteFile 替代，既符合现代 Go 最佳实践，也便于新项目开发与旧代码维护，帮你避开版本陷阱，写出更健壮、可持续的文件操作代码。

Golang如何使用io/ioutil写入文件_Golang ioutil文件写入实践

在 Go 语言中，io/ioutil 包曾被广泛用于文件的读写操作。虽然从 Go 1.16 开始该包已被标记为废弃，推荐使用 os 和 io 包中的函数替代，但了解 ioutil 的文件写入方式对维护旧项目仍有帮助。

使用 ioutil.WriteFile 写入字符串内容

ioutil 提供了 WriteFile 函数，可以快速将数据写入文件，无需手动管理文件句柄。

函数签名如下：

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

示例：将一段文本写入文件

package main

import (
  "io/ioutil"
  "log"
)

func main() {
  content := "Hello, Golang!\n这是使用 ioutil 写入的内容。"
  err := ioutil.WriteFile("output.txt", []byte(content), 0644)
  if err != nil {
    log.Fatal(err)
  }
  log.Println("文件写入成功")
}

写入二进制数据

除了文本，ioutil.WriteFile 同样适用于图片、音频等二进制数据。

例如，复制一个图片文件的内容到新文件：

data, err := ioutil.ReadFile("source.jpg")
if err != nil {
  log.Fatal(err)
}

err = ioutil.WriteFile("copy.jpg", data, 0644)
if err != nil {
  log.Fatal(err)
}
log.Println("图片复制完成")

注意事项与替代方案

尽管 ioutil 使用简单，但自 Go 1.16 起官方建议迁移到更现代的 API。

等效的 os 写入方式：

import "os"

err := os.WriteFile("output.txt", []byte(content), 0644)
if err != nil {
  log.Fatal(err)
}

新方法功能一致，且无需引入额外包。

基本上就这些。对于新项目，直接使用 os.WriteFile 更符合当前 Go 的实践规范。ioutil 的写入方式虽简洁，但已属于历史用法。掌握其原理有助于理解代码演进过程。不复杂但容易忽略版本差异。

本篇关于《Golangioutil写入文件方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>