应按场景拆解文件操作，避免大而全的 utils.File 包；os.Create 等价于清空并创建，追加日志等场景须用 os.OpenFile 显式指定 flag；perm 在 Windows 无效；错误需类型判断；bufio.Scanner 默认缓冲区 64KB，超长行会报 ErrTooLong。
直接上结论：别封装成 utils.File 这种大而全的包，而是按场景拆解——读、写、路径、元数据、原子操作，每个函数只做一件事，且显式暴露错误和参数边界。
os.OpenFile 与 os.Create 的适用边界
很多人一上来就用 os.Create 写文件，但它的语义是「清空并创建」，等价于 os.OpenFile(name, os.O_CREATE|os.O_TRUNC|os.O_WRONLY, 0666)。一旦误用于追加日志或配置更新，就会丢数据。
- 用
os.OpenFile显式控制 flag：追加日志用os.O_APPEND | os.O_CREATE | os.O_WRONLY；只读配置用os.O_RDONLY；覆盖写用os.O_TRUNC | os.O_WRONLY -
perm参数在 Windows 下被忽略，不要依赖它设权限；Linux/macOS 下建议固定用0644（普通文件）或0755（可执行），避免传0777引发安全告警 - 错误检查不能只看
err != nil，要判断是否是*os.PathError，比如路径不存在时可自动创建父目录，而权限拒绝时应提前报错
bufio.Scanner 读大文件时的内存陷阱
bufio.Scanner 默认缓冲区只有 64KB，遇到单行超长日志（如 minified JSON、base64 blob）会直接返回 scanner.ErrTooLong，而不是继续扫描。这不是 bug，是设计使然。
- 读纯文本日志：调用
scanner.Buffer(make([]byte, 4096), 1 把最大行长度设为 1MB - 读二进制或不确定格式：别用
Scanner，改用io.ReadFull或分块io.CopyN+bytes.Buffer - 永远配超时：
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)，防止卡死在阻塞 IO 上
原子写入必须绕过 os.Rename 的跨设备限制
想实现「写临时文件 → 替换原文件」的原子更新？os.Rename 在不同文件系统（比如 /tmp 和 /var/log 不在同一挂载点）会失败，报 invalid cross-device link。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：用
os.WriteFile（Go 1.16+）或ioutil.WriteFile（已弃用但兼容）写临时文件，再用os.Chmod设权限，最后调用os.Link+os.Remove模拟原子替换（仅限同一设备） - 更健壮方案：先
os.OpenFile(tmpPath, os.O_CREATE|os.O_WRONLY, 0600)，写完f.Sync()，再f.Close()，最后os.Rename—— 如果 rename 失败，清理 tmp 文件并返回 error - 别省略
f.Sync()：Linux 默认启用 write-back cache，不 sync 可能导致断电后文件内容丢失
路径拼接必须用 filepath.Join 而非字符串拼接
硬拼 "dir/" + filename 在 Windows 下会生成 dir/\file.txt，触发 invalid argument 错误；而 filepath.Join("dir", filename) 自动适配平台分隔符。
- 所有路径输入都应先
filepath.Clean()：过滤掉../、重复/、末尾斜杠，防止路径遍历（如用户传../../etc/passwd） - 敏感操作前校验路径是否在允许根目录下：
if !strings.HasPrefix(absPath, allowedRoot) { return errors.New("path outside root") } - 不要用
path/filepath处理 URL 路径——那是net/url的事；也不要拿filepath.Base提取文件名后直接拼命令行参数，需额外shellescape
最易被忽略的点：文件描述符泄漏。每次 os.Open 都要配 defer f.Close()，但嵌套函数或错误分支里容易漏掉；更稳妥的是把打开、操作、关闭封装成一个函数，用闭包确保 Close 执行，哪怕中间 panic。
