Go语言文件操作IO保姆级指南：从打开到避坑，一篇全搞定（附速查表）

Go语言文件操作IO保姆级指南从打开到避坑一篇全搞定附速查表阅读本文你将收获彻底搞懂 Go 语言中的文件操作、IO 流概念、os包与bufio包的使用方式以及文件指针变化带来的各种“坑”。目录Go语言文件操作IO保姆级指南从打开到避坑一篇全搞定附速查表一、核心概念文件与流什么是流二、打开/创建文件一切操作的起点2.1 os.Create2.2 os.Open2.3 os.OpenFileFlag 标志位速查2.4 Linux 文件权限速查三、读取文件四种方式全解析3.1 file.Read —— 手动控制缓冲区3.2 io.ReadAll —— 一次性读完3.3 os.ReadFile —— 最简洁的方式3.4 bufio.Reader —— 逐行读取四、写入文件三种姿势4.1 file.Write / file.WriteString4.2 bufio.Writer —— 带缓冲写入4.3 os.WriteFile —— 一步到位五、IO 接口Go 的读写灵魂5.1 io.Reader5.2 io.Writer5.3 io.Copy —— 拷贝就这么简单六、文件指针90% 的 Bug 来源6.1 什么是文件指针6.2 file.Seek —— 手动操控指针6.3 各操作对指针的影响表6.4 经典踩坑场景坑 1ReadAll 之后再 Read —— 啥也读不到坑 2读取后写入会覆盖坑 3bufio.Writer 忘记 Flush七、文件信息与目录操作7.1 file.Stat —— 获取文件信息7.2 目录操作7.3 路径拼接八、快速参考速查表操作三合一速查方案选择决策树九、总结三个核心概念两条黄金法则三个最常见的坑一、核心概念文件与流在开始写代码之前先理解一个关键概念文件在程序中是以流的形式来操作的。什么是流流Stream数据在数据源文件/网络/数据库和程序内存之间经历的路径。输入流Input Stream数据从数据源 → 程序内存即读取输出流Output Stream数据从程序内存 → 数据源即写入一句话总结程序本身只操作内存但文件在磁盘、数据库在服务器、网络数据在网卡——所以需要IO。二、打开/创建文件一切操作的起点无论读还是写第一步永远是获取文件指针以下file均代表文件指针。2.1 os.Create// 无则创建有则清空相当于 O_CREATE | O_TRUNC | O_WRONLYfile,err:os.Create(test.txt)iferr!nil{panic(err)}deferfile.Close()// 记得关闭特性说明文件存在清空原有内容文件不存在创建新文件打开模式只写2.2 os.Open// 以只读方式打开文件file,err:os.Open(test.txt)iferr!nil{panic(err)}deferfile.Close()特性说明文件存在打开只读文件不存在返回错误打开模式只读2.3 os.OpenFile最灵活的方式可以精确控制打开行为// os.OpenFile(文件名, flag, 权限)file,err:os.OpenFile(test.txt,os.O_APPEND|os.O_CREATE|os.O_WRONLY,0644)iferr!nil{panic(err)}deferfile.Close()Flag 标志位速查标志含义使用场景O_RDONLY只读读取配置文件O_WRONLY只写写入日志O_RDWR读写需要同时读写的场景O_APPEND追加到文件末尾写日志防止覆盖O_CREATE文件不存在则创建确保文件一定存在O_EXCL文件存在则报错创建锁文件防止重复创建O_TRUNC打开时清空文件覆盖写入O_SYNC同步写入磁盘重要数据不容丢失多个 flag 用|分隔os.O_CREATE | os.O_WRONLY2.4 Linux 文件权限速查os.OpenFile的第三个参数是 Linux 风格的数字权限使用的是八进制r读w写x执行数字权限0---无权限1--x执行2-w-写3-wx写执行4r--读5r-x读执行6rw-读写7rwx读写执行// 常见权限示例os.OpenFile(file.txt,os.O_CREATE|os.O_WRONLY,0644)// rw-r--r--os.OpenFile(file.txt,os.O_CREATE|os.O_WRONLY,0755)// rwxr-xr-x记忆技巧读4写2执行1三者相加就是权限数字。6 42 读写。三、读取文件四种方式全解析3.1 file.Read —— 手动控制缓冲区file,err:os.Open(test.txt)iferr!nil{panic(err)}deferfile.Close()buf:make([]byte,1024)// 创建 1024 字节的缓冲区n,err:file.Read(buf)// n 实际读取的字节数iferr!nil{panic(err)}fmt.Println(string(buf[:n]))// 只输出有效数据0 到 n-1适用场景处理大文件需要精确控制每次读取的字节数。可以通过控制buf的长度大小来控制每次读取的字节数注意一定要用buf[:n]而不是buf因为buf的尾部可能包含上次读取的残留数据3.2 io.ReadAll —— 一次性读完importiofile,_:os.Open(test.txt)deferfile.Close()data,err:io.ReadAll(file)// data 是 []byte 类型iferr!nil{panic(err)}fmt.Println(string(data))// 需要 string() 转换适用场景文件不大想一次性全部读入内存。Go 1.16 之前用ioutil.ReadAll现已移至io.ReadAll。3.3 os.ReadFile —— 最简洁的方式// 注意直接传文件名不需要先 Opendata,err:os.ReadFile(test.txt)// data 是 []byte 类型iferr!nil{panic(err)}fmt.Println(string(data))Go 1.16 新增一行代码搞定读文件。内部自动完成打开→读取→关闭。适用场景快速读取小文件配置文件、模板等。3.4 bufio.Reader —— 逐行读取import(bufioio)file,_:os.Open(test.txt)deferfile.Close()reader:bufio.NewReader(file)for{line,err:reader.ReadString(\n)// 读到一个换行符为止// 或者 reader.ReadBytes(\n) —— 返回 []bytefmt.Print(line)iferrio.EOF{// 到达文件末尾break}}方法返回值说明ReadString(\n)string读到指定分隔符为止ReadBytes(\n)[]byte同上返回字节切片ReadLine()[]byte读一行不推荐四、写入文件三种姿势4.1 file.Write / file.WriteStringfile,err:os.Create(output.txt)// 有则清空无则创建iferr!nil{panic(err)}deferfile.Close()// 方式一写 []byten,err:file.Write([]byte(Hello, Go!\n))// 方式二直接写字符串n,errfile.WriteString(第二行内容\n)fmt.Printf(写入了 %d 字节\n,n)4.2 bufio.Writer —— 带缓冲写入importbufiofile,_:os.Create(output.txt)deferfile.Close()writer:bufio.NewWriter(file)// 创建带缓冲的 Writerwriter.WriteString(第一行\n)writer.WriteString(第二行\n)writer.WriteString(第三行\n)writer.Flush()// ⚠️ 必须调用否则数据不会真正写入文件这是最常见的坑bufio.Writer先把数据写到内存缓冲区只有调用Flush()才会真正刷到磁盘。忘记Flush() 文件空空如也4.3 os.WriteFile —— 一步到位data:[]byte(Hello, Go!)err:os.WriteFile(output.txt,data,0644)iferr!nil{panic(err)}一行代码完成打开 → 写入 → 关闭。Go 1.16 新增。三种写入方式对比方式使用场景注意file.Write需要多次写入、追加需手动 OpenFilebufio.Writer频繁小量写入减少系统调用必须 Flushos.WriteFile一次性写完简单快捷每次都会覆盖五、IO 接口Go 的读写灵魂Go 语言的 IO 设计极其优雅——通过两个核心接口统一了所有读写操作5.1 io.ReadertypeReaderinterface{Read(p[]byte)(nint,errerror)}任何拥有Read方法的类型都可以称为Reader。funcreadAll(r io.Reader){buf:make([]byte,1024)n,_:r.Read(buf)fmt.Println(string(buf[:n]))}// 以下全部可以传入 readAllreadAll(os.Stdin)// 标准输入readAll(strings.NewReader(hello))// 字符串readAll(bytes.NewBuffer([]byte(world)))// 字节缓冲区readAll(file)// 文件这就是 Go 接口的威力——函数不关心数据来自哪里只关心它可读。5.2 io.WritertypeWriterinterface{Write(p[]byte)(nint,errerror)}任何拥有Write方法的类型都可以称为Writer。funcwriteData(w io.Writer,datastring){w.Write([]byte(data))}// 以下全部可以传入 writeDatawriteData(os.Stdout,hello)// 输出到控制台writeData(file,hello)// 输出到文件writeData(bytes.Buffer{},hello)// 输出到内存缓冲区5.3 io.Copy —— 拷贝就这么简单// 将 src 的内容复制到 dstwritten,err:io.Copy(dst Writer,src Reader)// 实际应用复制文件srcFile,_:os.Open(source.txt)defersrcFile.Close()dstFile,_:os.Create(copy.txt)deferdstFile.Close()io.Copy(dstFile,srcFile)// 一行搞定文件复制io.Copy内部使用 32KB 的缓冲区循环读取并写入直到io.EOF。六、文件指针90% 的 Bug 来源6.1 什么是文件指针操作系统为每个打开的文件维护一个文件指针offset标记当前读/写到哪个位置了。文件内容H e l l o W o r l d 位置 0 1 2 3 4 5 6 7 8 9 10 指针0从 H 开始读 指针6从 W 开始读 指针11在文件末尾读取返回 io.EOF6.2 file.Seek —— 手动操控指针file.Seek(offsetint64,whenceint)(int64,error)whence 常量起始位置说明io.SeekStart文件开头offset ≥ 0io.SeekCurrent当前指针位置offset 可正可负io.SeekEnd文件末尾offset ≤ 0// 回到文件开头file.Seek(0,io.SeekStart)// 跳过前 10 个字节file.Seek(10,io.SeekStart)// 从当前位置向前移动 5 字节file.Seek(5,io.SeekCurrent)// 定位到文件末尾常用于追加前获取文件大小size,_:file.Seek(0,io.SeekEnd)6.3 各操作对指针的影响表操作offset 变化方式File.Read()向后移动读取的字节数io.ReadAll()移动到文件末尾bufio.Reader.Read()底层读取offset 随之移动File.Write()向后移动写入的字节数WriteString()向后移动字符串的字节数bufio.Writer.Write()写入缓冲区不立即移动Flush 后才移动Flush()实际写入多少offset 移动多少Seek()直接设置到指定位置O_APPEND写入写入前自动跳到文件末尾O_TRUNC打开文件清空内容offset 06.4 经典踩坑场景坑 1ReadAll 之后再 Read —— 啥也读不到file,_:os.Open(test.txt)data,_:io.ReadAll(file)// 指针已到末尾fmt.Println(string(data))// 正确 有数据buf:make([]byte,10)n,_:file.Read(buf)// 错误 n0指针已在末尾fmt.Println(n)// 输出0解决读完要再读先file.Seek(0, io.SeekStart)回到开头。坑 2读取后写入会覆盖// 文件原内容Hello World长度 11file,_:os.OpenFile(test.txt,os.O_RDWR,0644)deferfile.Close()buf:make([]byte,6)file.Read(buf)// 读取 Hello 6 字节指针6file.WriteString(Go)// 从指针位置覆盖写入指针9结果文件变成Hello Gorld——Go覆盖了Wo原文件H e l l o W o r l d 操作 读取前6位→ 指针到6→ 写入Go覆盖位置6和7 结果 H e l l o G o r l d解决如果要在文件末尾写用file.Seek(0, io.SeekEnd)或O_APPEND。坑 3bufio.Writer 忘记 Flushfile,_:os.Create(test.txt)writer:bufio.NewWriter(file)writer.WriteString(重要数据)// 忘记 writer.Flush()file.Close()// Close 也不会帮你 Flush bufio.Writer结果文件是空的解决defer writer.Flush()是好习惯但Flush返回的error也要检查deferfunc(){iferr:writer.Flush();err!nil{panic(err)}file.Close()}()七、文件信息与目录操作7.1 file.Stat —— 获取文件信息info,err:file.Stat()// 或 os.Stat(文件名)iferr!nil{panic(err)}fmt.Println(文件名,info.Name())// eg:test.txtfmt.Println(文件大小,info.Size())// int64单位字节fmt.Println(权限,info.Mode())// -rw-r--r--fmt.Println(修改时间,info.ModTime())// 最后修改时间fmt.Println(是目录,info.IsDir())// true / false7.2 目录操作// 重命名文件/目录err:os.Rename(old_name.txt,new_name.txt)// 删除文件或空目录err:os.Remove(file.txt)// 删除非空目录递归删除err:os.RemoveAll(directory/)// 创建单层目录err:os.Mkdir(newdir,0755)// 递归创建多级目录类似 mkdir -perr:os.MkdirAll(a/b/c/d,0755)// 自动创建 a → a/b → a/b/c → a/b/c/d// 读取目录内容不包含子目录的文件files,err:os.ReadDir(.)for_,f:rangefiles{fmt.Println(f.Name())// 文件名fmt.Println(f.IsDir())// 是否是目录}注意os.Remove删除非空目录会失败要用os.RemoveAll。7.3 路径拼接importpath/filepath// 跨平台路径拼接path:filepath.Join(a,b,c.txt)// Windows: a\b\c.txt// Linux: a/b/c.txt// 也支持多级拼接fullPath:filepath.Join(/home,user,projects,main.go)注意不要手动拼路径字符串a/ b用filepath.Join自动处理跨平台分隔符。八、快速参考速查表操作三合一速查要做什么打开文件读取/写入关闭一行读不需要os.ReadFile(name)自动关闭一行写不需要os.WriteFile(name,data,perm)自动关闭逐行读os.Open(name)bufio.NewReader(f).ReadString(\n)defer f.Close()追加写os.OpenFile(name, O_APPEND|O_CREATE|O_WRONLY, 0644)f.WriteString(s)defer f.Close()拷贝文件os.Open(src)os.Create(dst)io.Copy(dstFile, srcFile)defer都关方案选择决策树读取文件 ├── 文件很小 → os.ReadFile() ├── 需要逐行处理 → bufio.NewReader ReadString(\n) ├── 需要控制每次读取大小 → file.Read(buf) └── 所有内容一次性处理 → io.ReadAll(file) 写入文件 ├── 一次性全部写入 → os.WriteFile() ├── 需要多次写入 → file.Write / file.WriteString ├── 频繁小量写入 → bufio.NewWriter Flush() └── 追加到末尾 → OpenFile(..., O_APPEND, ...)九、总结三个核心概念流Stream数据在数据源和程序内存之间的通道——输入流读输出流写文件指针Offset操作系统帮你维护的当前读写位置是大多数 Bug 的根源io.Reader / io.WriterGo 的 IO 灵魂接口——所有可读/可写的东西都实现了它们两条黄金法则读取文件前必须先打开os.ReadFile除外它帮你在内部做了bufio.Writer必须Flush()否则数据永远到不了磁盘三个最常见的坑坑原因解决ReadAll后再Read啥也读不到指针已在末尾Seek(0, io.SeekStart)读取部分内容后写入把原内容覆盖了指针在中间写入会覆盖先Seek到末尾或用O_APPEND程序跑了半天打开文件一看啥也没有bufio.Writer忘了Flushdefer writer.Flush()本文涵盖了日常开发中最常用的文件操作场景。熟记文件指针的变化规律就能避开 90% 的文件操作 Bug。如果本文对你有帮助欢迎点赞收藏