一、核心函数概览

二、基础读写操作

1. ReadFile文件读取

// 读取文件内容（自动处理打开/关闭）
data, err := os.ReadFile("config.json")  // 替代 ioutil.ReadFile
if err != nil {
    log.Fatal("读取失败:", err)
}
fmt.Printf("文件内容:\n%s", data)

2. WriteFile文件写入

// 覆盖写入数据（权限示例：0644=用户读写，组和其他只读）
content := []byte("Hello, Go 1.16+!")
err := os.WriteFile("output.txt", content, 0644)
if err != nil {
    log.Fatal("写入失败:", err)
}

三、进阶技巧与性能优化

1. 大文件处理策略

分块读取示例：

file, _ := os.Open("large.log")
defer file.Close()

reader := bufio.NewReader(file)
buffer := make([]byte, 4096)  // 4KB 缓冲区
for {
    n, err := reader.Read(buffer)
    if err == io.EOF {
        break
    }
    process(buffer[:n])
}

2. 错误处理最佳实践

• 检查文件是否存在：

if _, err := os.Stat("data.txt"); errors.Is(err, os.ErrNotExist) {
    log.Fatal("文件不存在")
}

• 处理只读文件写入：

err := os.WriteFile("readonly.txt", data, 0444)  // 权限冲突
if errors.Is(err, syscall.EACCES) {
    log.Fatal("无写入权限")
}

四、弃用说明与迁移指南

Go 1.16+ 将 ioutil 部分函数迁移至 os 和 io 包，旧代码需逐步替换：

五、常见错误与陷阱

1. 资源泄漏

// 错误：未关闭临时文件（ioutil.TempFile 返回的 *os.File 需手动关闭）
tmpfile, _ := os.CreateTemp("", "example")
defer tmpfile.Close()  // 必须添加

2. 权限问题

// 错误：尝试在只读目录中创建文件
err := os.WriteFile("/system/config.cfg", data, 0644)  // 可能因权限不足失败

3. 路径处理

// 错误：硬编码路径分隔符（Windows不兼容）
data, _ := os.ReadFile("data\\file.txt")  // 应改用 filepath.Join("data", "file.txt")

六、实战示例

1. JSON配置文件加载

type Config struct {
    Port int    `json:"port"`
    Env  string `json:"env"`
}

func LoadConfig(path string) (*Config, error) {
    data, err := os.ReadFile(path)
    if err != nil {
        return nil, err
    }

    var cfg Config
    if err := json.Unmarshal(data, &cfg); err != nil {
        return nil, fmt.Errorf("解析失败: %v", err)
    }
    return &cfg, nil
}

2. 日志批量写入

func WriteLogs(entries []string, filename string) error {
    var buf bytes.Buffer
    for _, entry := range entries {
        buf.WriteString(entry)
        buf.WriteByte('\n')
    }
    return os.WriteFile(filename, buf.Bytes(), 0644)
}

七、跨平台注意事项

1. 路径分隔符：始终使用 filepath.Join() 构建路径
2. 换行符差异：\n 在写入时会自动转换为系统默认（如Windows的 \r\n）
3. 临时文件目录：优先使用 os.TempDir() 获取系统临时目录

通过掌握 io/ioutil 简化IO操作及迁移至新标准库的方法，可快速实现高效文件读写。建议结合项目需求选择适合的读写策略，并始终遵循以下原则：

• 小文件：优先使用 os.ReadFile/os.WriteFile
• 大文件：分块处理 + 流式读写
• 错误检查：强制处理所有IO操作的错误返回值