os — 操作系统交互

// 等价关系
os.Open(name)     // = OpenFile(name, O_RDONLY, 0)
os.Create(name)   // = OpenFile(name, O_RDWR|O_CREATE|O_TRUNC, 0666)

// 追加写入
file, _ := os.OpenFile("log.txt", O_CREATE|O_WRONLY|O_APPEND, 0644)

// 原子创建（文件存在则失败）
file, _ := os.OpenFile("lock.pid", O_CREATE|O_WRONLY|O_EXCL, 0644)

// 每个数字 = r(4) + w(2) + x(1)
// 7 = 4+2+1 = rwx （读+写+执行）
// 5 = 4+0+1 = r-x （读+执行，不能写）
// 4 = 4+0+0 = r-- （只读）
// 6 = 4+2+0 = rw- （读+写，不能执行）

// 三个数字分别代表：所有者(user) | 所属组(group) | 其他人(other)
os.WriteFile("public.txt", data, 0644)  // rw-r--r--
os.WriteFile("secret.key", data, 0600)  // rw-------
os.WriteFile("script.sh", data, 0755)   // rwxr-xr-x

// Go 中还支持 os.FileMode 常量（不常用，更冗长）
mode := os.FileMode(0644) | os.ModeSticky  // 额外位

// 完整权限 = 4 位八进制数：特殊位 + 3 组 rwx
os.Mkdir("/tmp/mydir", 01777)  // sticky + rwxrwxrwx（类似 /tmp）
os.Chmod("script.sh", 04755)   // setuid + rwxr-xr-x

// 实际创建权限 = 程序指定权限 & (^umask)
// umask = 0022 时：
//   程序指定 0666 → 实际 0644 (rw-r--r--)
//   程序指定 0777 → 实际 0755 (rwxr-xr-x)
//
// umask = 0002 时：
//   程序指定 0666 → 实际 0664 (rw-rw-r--)
//
// 查看 umask：终端执行 umask
// Docker 容器中: 通常是 0000 或 0022

// 推荐使用（自动打开+关闭）
data, err := os.ReadFile("file.txt")           // 读取全部
err := os.WriteFile("file.txt", data, 0644)    // 写入全部
entries, err := os.ReadDir(".")                // 读取目录

file, err := os.Open("data.txt")
if err != nil {
    return err
}
defer file.Close()  // 紧跟错误检查之后

// 使用 file

// 只读文件：Close 错误通常可忽略
defer file.Close()

// 写入文件：Close 可能返回 flush 错误
defer func() {
    if err := file.Close(); err != nil {
        log.Printf("close error: %v", err)
    }
}()

// 创建目录
os.Mkdir("mydir", 0755)           // 创建单级目录
os.MkdirAll("a/b/c", 0755)        // 创建多级目录（类似 mkdir -p）

// 删除
os.Remove("file.txt")             // 删除文件或空目录
os.RemoveAll("mydir")             // 递归删除（谨慎！）

// 遍历目录（推荐 Go 1.16+）
entries, _ := os.ReadDir(".")
for _, entry := range entries {
    fmt.Printf("%s (dir=%v)\n", entry.Name(), entry.IsDir())
}

// 遍历目录树
filepath.WalkDir(".", func(path string, d fs.DirEntry, err error) error {
    if err != nil {
        return err
    }
    fmt.Println(path)
    return nil
})

// 获取
val := os.Getenv("PATH")                    // 不存在返回 ""
val, ok := os.LookupEnv("MY_VAR")           // 区分空值和未设置

// 设置
os.Setenv("APP_MODE", "production")         // 影响当前进程+子进程

// 删除
os.Unsetenv("TEMP_VAR")

// 获取所有环境变量
for _, env := range os.Environ() {
    fmt.Println(env) // "KEY=value"
}

// 命令行参数
fmt.Println(os.Args) // ["/path/to/app", "arg1", "arg2"]

// 退出（跳过 defer！）
os.Exit(1) // ← defer 不会执行

// 临时文件
tmpFile, _ := os.CreateTemp("", "prefix-*.txt")
defer os.Remove(tmpFile.Name())  // 清理
defer tmpFile.Close()

tmpFile.Write(data)
tmpFile.Sync() // 确保落盘

// 临时目录
tmpDir, _ := os.MkdirTemp("", "myapp-*")
defer os.RemoveAll(tmpDir)

// 系统临时目录
fmt.Println(os.TempDir()) // /tmp (Linux) 或 %TEMP% (Windows)