Golang 基础笔记十四之文件操作

作者：Hunter熊

2025-07-23
北京
本文字数：4497 字
阅读完需：约 15 分钟

本文首发于公众号：Hunter 后端
原文链接：Golang基础笔记十四之文件操作

这一篇笔记介绍 Golang 里文件的相关操作，主要用的库是 io。

以下是本篇笔记目录：

文件读取
文件写入
文件追加
os.OpenFile()
文件属性

1、文件读取

1. 文件的打开与关闭

1) os.Open()

打开一个文件可以使用 os.Open() 函数，其代码示例如下:

filePath := "a.txt"file, err := os.Open(filePath)

复制代码

我们可以通过判断 err 是否等于 nil 来决定是否可以接着读取文件，假设这里的 filePath 不存在，那么 err 则的信息则会是:

open file fail, err: open a.txt: The system cannot find the file specified.

复制代码

file 的具体读取操作在后面再介绍。

2) file.Close()

在打开文件后，我们可以使用 defer file.Close() 操作来确保文件最后会被正常关闭。

2. 文件内容的读取

在文件打开以后，介绍几种对文件进行读取的方式，以下是打开文件的代码：

filePath := "a.txt"file, err := os.Open(filePath)if err != nil {    fmt.Println("open file fail, err:", err)    return}defer file.Close()

复制代码

假设 a.txt 文件内容为：

第一行second_lineend of line

复制代码

1) 一次性读取

如果目标文件不大，希望一次性读取文件内容的话，可以使用 io.ReadAll() 函数：

data, err := io.ReadAll(file)if err != nil {    fmt.Println("read file error: ", err)    return}fmt.Println("read file data: ", string(data))return

复制代码

返回的结果是一个 []byte 类型，可以使用 string() 将其转换为字符串。

2) 分块读取

如果文件过大，我们可以分块读取，每次读取指定字节数的数据，下面提供一个示例，用于分批次读取文件内容，直到读完整个文件：

data := make([]byte, 6)for {    count, err := file.Read(data)    if err == io.EOF {        fmt.Println("end of file, exit")        break    }    if err != nil {        fmt.Println("Error: ", err)        break    }    if count > 0 {        fmt.Println("read count: ", count, ", data: ", string(data[:count]))    }}

复制代码

这里我们定义了一个长度为 6 的 byte 数组，然后在 for 循环里一直使用 file.Read() 读取，每次都往 data 中填充数据，直到读取到文件末尾，或者读取出现 error。

在这里需要注意，Go 里对读取文件到末尾的信息包装成了一个 error，我们需要进行判断下。

file.Seek()

在读取文件内容的时候，我们还可以指定指针读取的位置，比如重置读取的指针到开头，我们可以如下操作：

file.Seek(0, io.SeekStart)

复制代码

file.Seek() 函数接收两个参数，一个是偏移量，一个是起始位置，上面这行代码的含义就是从文件开头的偏移量为 0 的位置开始读取文件内容。

如果我们想从文件开头往后三个字节长度的地方开始读取，可以如下操作：

file.Seek(3, io.SeekStart)

复制代码

而指定读取有三个参数：

const (    SeekStart   = 0 // seek relative to the origin of the file    SeekCurrent = 1 // seek relative to the current offset    SeekEnd     = 2 // seek relative to the end)

复制代码

分别表示文件开头，指针当前位置和文件末尾。

当然，file.Seek() 的第一个参数也可以是负数，比如我们想读取文件最后六个字节的内容，可以如下操作：

file.Seek(-6, io.SeekEnd)

复制代码

3) 按行读取

我们可以使用 bufio.NewScanner() 函数来按行读取文件内容：

file.Seek(0, io.SeekStart)scanner := bufio.NewScanner(file)
for scanner.Scan() {    fmt.Println(scanner.Bytes(), scanner.Text())}

复制代码

这里，我们使用了两个内容，一个是 .Bytes()，一个是 .Text()，分别打印的内容是该行的字节数组和字符串数据。

2、文件写入

1. 文件的打开与关闭

文件写入的操作中，打开与关闭一个文件的操作如下：

filePath := "a.txt"file, err := os.Create(filePath)if err != nil {    fmt.Println("create file error: ", err)    return}
defer file.Close()

复制代码

使用到的函数是 os.Create()，在这里，如果目标文件 filePath 不存在则会自动创建一个文件，如果存在，则会清空原来的数据，重新写入。

2. 文件内容的写入

文件打开以后，下面介绍几种写入内容的方式

1) file.Write()

可以直接使用 file 以字节数组的形式往文件写入数据：

    n, err := file.Write([]byte("first line\n"))    if err != nil {        fmt.Println("write error: ", err)        return    }    fmt.Printf("write %d bytes", n)

复制代码

这里需要注意，如果要换行需要在末尾手动加上 \n 字符。

2) io.WriteString()

我们也可以使用 io.WriteString() 函数往文件里写入数据：

    n, err := io.WriteString(file, "first line\n")    if err != nil {        fmt.Println("write error: ", err)        return    }    fmt.Printf("write %d ", n)

复制代码

3) bufio.NewWriter()

我们还可以使用 bufio.NewWriter() 函数写入，这种操作是以缓冲的形式写入，操作示例如下：

    writer := bufio.NewWriter(file)    n, err := writer.WriteString("first line\n")    if err != nil {        fmt.Println("write error: ", err)        return    }    writer.Flush()    fmt.Printf("write %d bytes\n", n)

复制代码

这种操作需要在最后使用 writer.Flush() 函数将数据从缓冲区写入文件。

3、文件追加

1. 文件的打开与关闭

如果要对文件内容进行追加，我们可以使用 os.OpenFile() 函数，以下是一个使用示例：

filePath := "a.txt"
file, err := os.OpenFile(filePath, os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)if err != nil {    fmt.Println("append file error: ", err)    return}defer file.Close()

复制代码

在这里，os.OpenFile() 函数接受三个参数，第一个是文件地址，第二个是标志位，第三个是文件的权限。

对于标志位，这里的 os.O_APPEND、os.O_WRONLY、os.O_CREATE 分别表示追加，只写和创建，这样即便是文件不存在也不会报错，而是会创建一个新文件。

2. 文件内容的追加

追加操作可以使用 file.Write() 来写入字节数组，或者 file.WriteString() 写入字符串：

file.Write([]byte("hello write byte\n"))file.WriteString("hello write string\n")

复制代码

4、os.OpenFile()

这里再单独介绍一下 os.OpenFile() 函数，这个函数在前面追问文件内容的时候已经使用过一次了，这里着重再讲一下。

os.OpenFile() 函数是上面介绍的这些操作的基础函数，也就是说读取文件使用的 os.Open()，写入文件使用的 os.Create()，在底层的逻辑里都是调用的 os.OpenFile()，不过是在具体实现的时候，根据不同的目标，比如读取或者写入来传入不同的参数以实现具体功能。

先来介绍 os.OpenFile() 函数的参数。

1. os.OpenFile() 参数

这个函数接收三个参数，name，flag 和 perm。

1) name

name 就是文件名称，string 类型，表示我们需要操作的目标文件。

2) flag

flag 表示的是操作的目的，比如前面介绍追加文件的时候用到的 os.O_APPEND|os.O_WRONLY|os.O_CREATE。

参数类型是 int，在源码里定义了一系列关于文件的操作，如下：

const (    // Exactly one of O_RDONLY, O_WRONLY, or O_RDWR must be specified.    O_RDONLY int = syscall.O_RDONLY // open the file read-only.    O_WRONLY int = syscall.O_WRONLY // open the file write-only.    O_RDWR   int = syscall.O_RDWR   // open the file read-write.    // The remaining values may be or'ed in to control behavior.    O_APPEND int = syscall.O_APPEND // append data to the file when writing.    O_CREATE int = syscall.O_CREAT  // create a new file if none exists.    O_EXCL   int = syscall.O_EXCL   // used with O_CREATE, file must not exist.    O_SYNC   int = syscall.O_SYNC   // open for synchronous I/O.    O_TRUNC  int = syscall.O_TRUNC  // truncate regular writable file when opened.)

复制代码

比如这里有 O_RDONLY 表示只读，O_WRONLY 表示只写，O_RDWR 表示读和写，在操作文件的时候，这几个参数之一是必传的，用来表示文件操作的目的是读或者写。

下面几个参数则需要和其他上面的几个参数之一合并使用，比如 O_APPEND 追加，O_CREATE 创建等。

上面我们介绍追加功能的时候，就是一个示例，内容是 os.O_APPEND|os.O_WRONLY|os.O_CREATE，这个操作首先通过必传的 os.O_WRONLY 表示是一个写操作，然后通过 os.O_APPEND 表示是追加操作，会在文件的末尾接着写入，而 os.O_CREATE 则表示如果目标文件不存在则创建一个新文件。

通过这种操作叠加的方式使我们追加文件的程序变得更健壮，不会因为文件不存在而报错。

3) perm

perm 表示权限，指的是我们操作文件的时候，对文件赋予的权限，和 Linux 上文件操作的权限是一致的，比如 0644 代表的含义是当前用户拥有可读可写，同用户组和其他用户组只拥有可读权限。

2. os.Open() 和 os.Create()

前面介绍了 os.Open() 和 os.Create() 分别用来读取和写入文件的操作示例，这两个函数背后也是通过调用 os.OpenFile() 来实现的。

1) os.Open()

os.Open() 函数在源代码中的定义如下：

func Open(name string) (*File, error) {    return OpenFile(name, O_RDONLY, 0)}

复制代码

可以看到通过 OpenFile() 给了一个只读的权限实现了读取文件内容的操作。

2) os.Create()

os.Create() 函数的源码如下：

func Create(name string) (*File, error) {    return OpenFile(name, O_RDWR|O_CREATE|O_TRUNC, 0666)}

复制代码

os.Create() 函数则是通过读写操作，不存在就创建文件操作，存在就对原文件进行截断操作的方式来实现写入。

3. os.ReadFile() 和 os.WriteFile()

除了上面介绍的读写操作，这里还介绍两个以 os.OpenFile() 函数为基础实现的读写操作，不过这两个函数的读和写都是一次性的，也就是会一次性读取文件全部内容，或者一次性写入全部内容。

1) os.ReadFile()

os.ReadFile() 函数操作示例如下：

    filePath := "a.txt"    data, err := os.ReadFile(filePath)    fmt.Println("data: ", string(data), ", err: ", err)

复制代码

返回的是一个字节数组，如果想要按行进行切割，可以使用 strings.Split(string(data), "\n") 操作。

2) os.WriteFile()

os.WriteFile() 操作示例如下：

    err = os.WriteFile(filePath, []byte("hello write byte\nok write done\nlast line write\n"), 0644)    fmt.Println("write error: ", err)

复制代码

这里将多行数据使用 \n 进行分隔。

5、文件属性

打开一个文件后，我们可以获取这个文件的相关属性。

可以如下操作：

filePath := "a.txt"file, _ := os.Open(filePath)
info, err := file.Stat()if err != nil {    fmt.Println("error: ", err)}defer file.Close()

复制代码

我们通过 file.Stat() 获取 FileInfo，文件的信息就都在 info 里了：

fmt.Println("文件名称: ", info.Name())fmt.Printf("文件大小为 %d bytes\n", info.Size())fmt.Printf("文件权限:%s, %o \n", info.Mode(), info.Mode())fmt.Println("文件上次修改时间为:", info.ModTime())

复制代码

这里文件权限打印出的字符串是 -rw-rw-rw-，然后我们打印其八进制的内容就是常见的 666 形式了。

发布于: 刚刚阅读数: 3

原文链接:【http://xie.infoq.cn/article/feb3619868c68829abfd24b4d】。

Hunter熊

关注

公众号：Hunter后端 2018-09-17 加入

Python后端工程师，欢迎互相沟通交流

发布

暂无评论

创作场景

Golang 基础笔记十四之文件操作

1、文件读取

1. 文件的打开与关闭

1) os.Open()

2) file.Close()

2. 文件内容的读取

1) 一次性读取

2) 分块读取

3) 按行读取

2、文件写入

1. 文件的打开与关闭

2. 文件内容的写入

1) file.Write()

2) io.WriteString()

3) bufio.NewWriter()

3、文件追加

1. 文件的打开与关闭

2. 文件内容的追加

4、os.OpenFile()

1. os.OpenFile() 参数

1) name

2) flag

3) perm

2. os.Open() 和 os.Create()

1) os.Open()

2) os.Create()

3. os.ReadFile() 和 os.WriteFile()

1) os.ReadFile()

2) os.WriteFile()

5、文件属性

Hunter熊

评论