Go文件读写错误源于代码未检查err：os.Open/Create后必须先判err再defer Close，避免nil指针panic；权限错误需用os.IsPermission分类处理；os.ReadFile/WriteFile不适用大文件或追加场景；Close()错误不可忽略，否则数据静默丢失。
Go 语言环境搭建本身不会直接引发文件读写错误，真正出问题的，是后续你写的代码在操作文件时没处理好 error —— 这类错误不是环境没装好，而是代码逻辑没兜住。
os.Open/os.Create 后不检查 err 导致 panic
这是最常踩的坑：调用 os.Open 或 os.Create 后直接对返回的 *os.File 调用 Read、Write 或 Close，而没先判断 err 是否为 nil。一旦路径不存在或权限不足，file 是 nil，后续任何方法调用都会触发 panic: invalid memory address or nil pointer dereference。
- 必须把
if err != nil判断放在defer file.Close()之前，且确保file非nil时才 defer - 不要用
if file == nil替代err != nil——os.Open在某些系统调用部分失败时可能返回非nil的*os.File和非nil的err - 示例错法：
file, _ := os.Open("missing.txt"); defer file.Close()→ 必崩 - 正确写法：
file, err := os.Open("config.json"); if err != nil { return err }; defer file.Close()
权限错误（permission denied）不是环境问题，是路径选择问题
permission denied 错误通常不是 Go 环境没配好，而是你硬编码了系统保护路径（如 /etc/、/var/log/），或当前用户对目标目录没有写权限（Linux/macOS 下还需父目录有 x 权限才能进入）。
- 避免写死绝对路径；改用
os.UserHomeDir()或os.TempDir()构建可写路径 - 写配置文件时优先读取
os.Getenv("XDG_CONFIG_HOME")（Linux）或os.Getenv("APPDATA")（Windows） - 若必须操作固定路径，先用
os.Stat检查，但注意它本身也可能因权限失败 —— 所以更推荐直接os.OpenFile并用os.IsPermission(err)分类处理 -
0644权限在 Windows 上被忽略，实际由 ACL 控制，别依赖它解决权限问题
os.ReadFile/os.WriteFile 看似简单，但掩盖了关键细节
os.ReadFile 和 os.WriteFile 是简化 API，适合小文件一次性读写，但它们无法帮你应对真实场景中的容错需求：
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
立即学习“go语言免费学习笔记（深入）”；
-
os.ReadFile把整个文件加载进内存，读 GB 级文件会 OOM；大文件必须用os.Open+bufio.Scanner或分块io.ReadFull -
os.WriteFile是覆盖写，不支持追加；要追加得用os.OpenFile(path, os.O_APPEND|os.O_WRONLY, 0644) - 它不保证原子性 —— 写入中途崩溃可能导致目标文件损坏；生产环境写关键文件应先写临时文件，再
os.Rename - 它不检查父目录是否存在；若路径中某级目录缺失，仍报
no such file or directory，需提前用os.MkdirAll(filepath.Dir(path), 0755)
Close() 错误被忽略，导致静默数据丢失
很多人以为 defer file.Close() 就万事大吉，但 Close() 本身可能返回错误（比如磁盘满、NFS 断连、缓冲区 flush 失败），而这个错误被忽略后，你认为“写成功了”，其实数据根本没落盘。
- 对关键写操作，应在
Close()后显式检查错误：if err := file.Close(); err != nil { log.Printf("close failed: %v", err) } - 如果用
os.WriteFile，它的错误只来自写入过程，不包含 close 阶段，所以更“干净”但更黑盒 - 批量操作多个文件时，不能只 defer 一个
Close()—— 每个打开的*os.File都要单独 close 并检查 -
bufio.Writer也一样：调用Flush()或Close()才真正落盘，漏掉就丢数据
真正的难点不在“怎么写”，而在“什么时候该重试、什么时候该降级、什么时候该提示用户”。比如 os.IsNotExist(err) 可自动创建默认配置，os.IsPermission(err) 就得明确告诉用户“请换路径或提权”，而不是笼统打日志完事。
