Go中读取文件推荐os.ReadFile(小文件)或os.Open配bufio.Scanner(大文件逐行)、io.Copy(流式复制);注意路径、权限、编码及内存安全。

在 Go 中读取文件内容最常用的方式是 ioutil.ReadFile(Go 1.16 起已移至 os.ReadFile)和 os.Open 配合 io.Read 系列函数。两者适用场景不同:前者适合小文件一次性读取,后者更灵活、内存友好,适合大文件或需要流式处理的场景。
使用 os.ReadFile 读取整个文件(推荐,简洁安全)
Go 1.16+ 官方推荐用 os.ReadFile 替代已弃用的 ioutil.ReadFile。它自动打开、读取、关闭文件,代码简短且不易出错。
- 函数签名:
os.ReadFile(filename string) ([]byte, error) - 返回原始字节切片,如需字符串可转为
string(data) - 内部已处理错误、资源释放,无需手动
close
示例:
func main() {data, err := os.ReadFile("config.txt")
if err != nil {
log.Fatal(err)
}
fmt.Println(string(data))
}
使用 os.Open + bufio.Scanner 逐行读取(适合文本日志、配置等)
当文件较大,或只需按行处理(如解析日志、CSV 行),避免一次性加载全部内容到内存,推荐用 os.Open 配合 bufio.Scanner。
立即学习“go语言免费学习笔记(深入)”;
-
os.Open返回*os.File,需显式defer f.Close() -
bufio.Scanner默认每行上限 64KB,超长行会报错;可通过ScanBytes或Bufio.Reader自定义 - 适合人类可读文本,不适用于含空字节或二进制数据
示例:
func main() {f, err := os.Open("lines.txt")
if err != nil {
log.Fatal(err)
}
defer f.Close()
scanner := bufio.NewScanner(f)
for scanner.Scan() {
line := scanner.Text() // 不含换行符
fmt.Println(line)
}
if err := scanner.Err(); err != nil {
log.Fatal(err)
}
}
使用 os.Open + io.ReadFull / io.Copy 读取任意大小(精细控制)
需要完全掌控读取过程时(如分块上传、加密解密、网络传输中继),可用 os.Open 获取 io.Reader,再配合底层读取函数。
-
io.ReadFull:确保读满指定长度,适合固定结构二进制头解析 -
io.Copy:高效复制(内部用 32KB 缓冲区),适合写入另一文件或网络连接 - 注意:
Read可能只读部分数据,需循环调用或用io.ReadAll(类似os.ReadFile)
示例(复制文件):
src, _ := os.Open("input.bin")dst, _ := os.Create("output.bin")
defer src.Close(); defer dst.Close()
io.Copy(dst, src) // 自动分块,高效安全
常见注意事项与避坑点
实际开发中容易忽略的关键细节:
- 路径问题:相对路径基于运行目录(
os.Getwd()),非源码所在目录;建议用filepath.Join拼接,避免硬编码/或\ - 权限错误:Linux/macOS 下无读权限、Windows 下文件被占用都会导致
open xxx: permission denied - 编码无关:Go 原生只处理字节,UTF-8 文本可直接转
string;GBK/GB2312 等需用golang.org/x/text/encoding转换 - 大文件 panic:用
os.ReadFile读 GB 级文件易触发 OOM;务必改用流式读取
不复杂但容易忽略。










