必须用 os.openfile 而非 os.open 的场景包括：需读写/追加/创建/截断文件，或设置权限；因 os.open 仅支持只读且不接受 flag 与 perm 参数。
os.OpenFile 是 Go 中唯一能精确控制文件打开行为的函数，os.Open 只是它的一个固定参数封装（等价于 os.OpenFile(name, os.O_RDONLY, 0)）。想读写、追加、创建、截断或设置权限，必须用 os.OpenFile。
什么时候必须用 os.OpenFile 而不是 os.Open
当操作涉及以下任一场景时，os.Open 会直接报错或无法满足需求：
-
os.Open固定只读，哪怕你传入os.O_WRONLY也会 panic —— 它根本不接受 flag 参数 - 需要向已有文件末尾追加内容？
os.O_APPEND只在os.OpenFile中有效 - 想创建不存在的文件并写入？必须组合
os.O_CREATE | os.O_WRONLY - 要清空文件再写？得加
os.O_TRUNC，且不能和os.O_APPEND同时用（冲突） - 需要设置文件权限（如 0644）？
os.Open的 perm 参数被忽略，只有os.OpenFile生效
flag 参数组合的常见错误与含义
flag 是位运算组合，必须用 | 连接，不能用 + 或逗号。常见合法组合及易错点：
-
os.O_CREATE | os.O_WRONLY：文件不存在则创建，存在则覆盖写（不自动清空，但通常配合os.O_TRUNC） -
os.O_CREATE | os.O_APPEND | os.O_WRONLY：安全追加——文件不存在则创建，存在则在末尾写 -
os.O_RDWR | os.O_CREATE | os.O_EXCL：确保新建文件（如果已存在，返回*os.PathError，os.IsExist(err)为 true） - 错误示例：
os.O_APPEND | os.O_TRUNC—— Go 不禁止，但行为未定义（实际取决于 OS），应避免 - 权限值（perm）只在创建文件时生效；对已存在文件无效，也不会修改其现有权限
权限参数 perm 的真实作用范围
perm 参数仅在文件被创建时起作用（即 flag 包含 os.O_CREATE 且文件原本不存在），它不会改变已有文件的权限：
- 典型值：
0644（用户可读写，组/其他只读）、0600（仅用户可读写） - 注意：Windows 忽略该参数，权限控制由 ACL 决定；Linux/macOS 下受 umask 影响，最终权限是
perm &^ umask - 如果忘记设 perm（传 0），新创建的文件可能变成 0000（不可读不可写），导致后续操作失败
- 不要传
777这类八进制字面量（Go 中777是十进制），正确写法是0777或0o777
关闭文件前务必检查 Write/Read 返回值
os.OpenFile 成功只代表句柄打开，不代表后续 I/O 一定成功。尤其在追加或写入时，容易忽略底层错误：
-
file.WriteString和file.Write都返回(int, error)，error 可能是磁盘满、权限不足、设备断开等 -
defer file.Close()不会捕获写入错误；必须在Close()前检查上一步 I/O 的 error - 更稳妥做法：用
file.Sync()强制刷盘后再Close()，否则程序崩溃可能导致数据丢失（尤其没用os.O_SYNC时） - 示例片段：
file, err := os.OpenFile("log.txt", os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0644) if err != nil { log.Fatal(err) } n, err := file.WriteString("entry\n") if err != nil { log.Printf("write failed: %v", err) // 不要忽略 } if n == 0 { log.Print("wrote 0 bytes") } err = file.Close() // Close 也可能失败（如 flush 失败） if err != nil { log.Printf("close failed: %v", err) }
真正麻烦的不是选错 flag，而是误以为 os.OpenFile 返回无误就万事大吉 —— I/O 错误常发生在写入或关闭瞬间，且不抛 panic，容易静默失败。
