Golang文件操作怎么做读写文件与目录遍历-Golang-PHP中文网

Golang文件操作怎么做读写文件与目录遍历

P粉602998670

发布： 2025-08-31 11:59:01

原创

244人浏览过

答案：Golang文件操作依赖os和io包，通过os.File、io.Reader、io.Writer及os包函数实现文件创建、读写、目录遍历；使用os.Create创建文件，file.Write或WriteString写入数据，os.Open结合file.Read读取内容，filepath.Walk遍历目录；大文件读取推荐bufio.NewReader逐行处理；错误需逐层检查并用defer关闭文件；文件是否存在可通过os.Stat和os.IsNotExist判断。

golang文件操作怎么做读写文件与目录遍历

Golang文件操作的核心在于

os

登录后复制

包和

io

登录后复制

包。通过它们，你可以轻松实现文件的创建、读取、写入，以及目录的遍历等常见任务。简单来说，就是用代码和文件系统打交道。

解决方案

Golang的文件操作围绕着几个核心概念：

os.File

登录后复制

（代表一个打开的文件），

io.Reader

登录后复制

（用于读取数据），

io.Writer

登录后复制

（用于写入数据），以及

os

登录后复制

包中的各种函数（如

Create

登录后复制

Open

登录后复制

Mkdir

登录后复制

等）。

1. 创建文件：

package main

import (
    "fmt"
    "os"
)

func main() {
    file, err := os.Create("example.txt")
    if err != nil {
        fmt.Println("创建文件失败:", err)
        return
    }
    defer file.Close() // 确保文件在使用完毕后关闭
    fmt.Println("文件创建成功！")
}

登录后复制

这段代码尝试创建一个名为

example.txt

登录后复制

的文件。如果创建过程中出现错误（比如权限不足），会打印错误信息。

defer file.Close()

登录后复制

确保在函数退出前关闭文件，这是一个良好的习惯，可以避免资源泄露。

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

2. 写入文件：

package main

import (
    "fmt"
    "os"
)

func main() {
    file, err := os.Create("example.txt")
    if err != nil {
        fmt.Println("创建文件失败:", err)
        return
    }
    defer file.Close()

    data := []byte("Hello, Golang file operation!\n")
    n, err := file.Write(data)
    if err != nil {
        fmt.Println("写入文件失败:", err)
        return
    }
    fmt.Printf("成功写入 %d 字节\n", n)

    // 也可以使用WriteString
    n, err = file.WriteString("Another line of text.\n")
    if err != nil {
        fmt.Println("WriteString 失败:", err)
        return
    }
    fmt.Printf("成功写入 %d 字节 (WriteString)\n", n)
}

登录后复制

这里，我们向

example.txt

登录后复制

文件写入了一段文本。

file.Write

登录后复制

接受一个字节切片作为输入。

file.WriteString

登录后复制

是一个更方便的函数，可以直接写入字符串。

3. 读取文件：

package main

import (
    "fmt"
    "io"
    "os"
)

func main() {
    file, err := os.Open("example.txt")
    if err != nil {
        fmt.Println("打开文件失败:", err)
        return
    }
    defer file.Close()

    buffer := make([]byte, 1024) // 创建一个缓冲区
    n, err := file.Read(buffer)
    if err != nil && err != io.EOF { // io.EOF 表示文件结束
        fmt.Println("读取文件失败:", err)
        return
    }
    fmt.Printf("读取了 %d 字节\n", n)
    fmt.Println(string(buffer[:n])) // 将读取到的字节转换为字符串并打印
}

登录后复制

这段代码打开

example.txt

登录后复制

文件并读取其内容。我们创建了一个缓冲区

buffer

登录后复制

来存储读取的数据。

file.Read

登录后复制

尝试从文件中读取数据到缓冲区，并返回读取的字节数。注意处理

io.EOF

登录后复制

错误，它表示已经到达文件末尾。

4. 目录遍历：

笔目鱼英文论文写作器

写高质量英文论文，就用笔目鱼

查看详情

package main

import (
    "fmt"
    "os"
    "path/filepath"
)

func main() {
    root := "." // 从当前目录开始
    err := filepath.Walk(root, func(path string, info os.FileInfo, err error) error {
        if err != nil {
            fmt.Println("访问出错:", err)
            return err
        }
        fmt.Println(path)
        return nil
    })
    if err != nil {
        fmt.Println("遍历目录失败:", err)
    }
}

登录后复制

filepath.Walk

登录后复制

函数可以递归地遍历目录树。它接受一个根路径和一个回调函数作为参数。对于遍历到的每个文件或目录，都会调用回调函数。回调函数的参数包括文件/目录的路径、

os.FileInfo

登录后复制

（包含文件/目录的信息），以及一个可能的错误。

如何高效读取大文件？

对于大文件，一次性读取到内存中是不现实的。更高效的做法是使用

bufio.NewReader

登录后复制

创建一个带缓冲的读取器，然后逐行读取文件内容。

package main

import (
    "bufio"
    "fmt"
    "os"
)

func main() {
    file, err := os.Open("large_file.txt")
    if err != nil {
        fmt.Println("打开文件失败:", err)
        return
    }
    defer file.Close()

    reader := bufio.NewReader(file)
    for {
        line, err := reader.ReadString('\n')
        if err != nil {
            if err != io.EOF {
                fmt.Println("读取行失败:", err)
            }
            break // 文件结束或发生错误
        }
        fmt.Println(line)
    }
}

登录后复制

这种方式可以避免一次性加载整个文件到内存，从而提高效率。

如何安全地处理文件错误？

文件操作中，错误处理至关重要。你需要检查每个可能出错的步骤，并采取适当的措施。这通常包括：

检查
```
os.Create
```
登录后复制
,
```
os.Open
```
登录后复制
,
```
file.Write
```
登录后复制
,
```
file.Read
```
登录后复制
等函数的返回值。
使用
```
defer file.Close()
```
登录后复制
确保文件在使用完毕后关闭。
记录错误信息，方便调试。
在必要时，进行错误恢复（例如，重试操作）。

一个更健壮的错误处理示例：

package main

import (
    "fmt"
    "os"
)

func writeFile(filename string, data []byte) error {
    file, err := os.Create(filename)
    if err != nil {
        return fmt.Errorf("创建文件失败: %w", err) // 使用 %w 包裹原始错误
    }
    defer func() {
        if closeErr := file.Close(); closeErr != nil {
            fmt.Println("关闭文件失败:", closeErr) // 记录关闭错误，但不影响主流程
        }
    }()

    _, err = file.Write(data)
    if err != nil {
        return fmt.Errorf("写入文件失败: %w", err)
    }
    return nil
}

func main() {
    err := writeFile("output.txt", []byte("This is some data.\n"))
    if err != nil {
        fmt.Println("发生错误:", err)
    } else {
        fmt.Println("文件写入成功！")
    }
}

登录后复制

这个示例使用了

fmt.Errorf

登录后复制

的

%w

登录后复制

动词来包裹原始错误，这使得你可以更容易地追踪错误的根源。同时，即使在关闭文件时发生错误，也会被记录下来，而不会影响程序的主流程。

如何判断文件或目录是否存在？

os.Stat

登录后复制

函数可以用来获取文件或目录的信息。如果文件或目录不存在，

os.Stat

登录后复制

会返回一个

os.ErrNotExist

登录后复制

错误。

package main

import (
    "fmt"
    "os"
)

func main() {
    _, err := os.Stat("myfile.txt")
    if err != nil {
        if os.IsNotExist(err) {
            fmt.Println("文件不存在")
        } else {
            fmt.Println("发生错误:", err)
        }
    } else {
        fmt.Println("文件存在")
    }
}

登录后复制