# go-zap

**Repository Path**: go_27/go-zap

## Basic Information

- **Project Name**: go-zap
- **Description**: 	// 创建开发环境日志记录器
	logger, _ := zap.NewDevelopment()
	//defer logger.Sync() // 程序退出前刷新日志缓冲区

	// 不同级别的日志输出
	logger.Debug("调试信息")
	logger.Info("普通信息")
	logger.Warn("警告信息")
	logger.Error("错误信息")
	logger.P
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# go-zap

#### 介绍
本项目是一个关于 Uber 的 zap 日志库（[go.uber.org/zap](https://github.com/uber-go/zap)）的学习教程，通过逐步深入的示例代码，展示了 zap 日志库的各种功能和使用技巧。zap 是一个高性能、结构化的日志库，特别适合对性能要求较高的 Go 语言应用程序。

#### 软件架构
项目采用渐进式学习结构，按照从基础到高级的顺序组织示例代码：

```
go-zap/
├── 1.zap基本使用.go      # 基础日志记录功能演示
├── 2.日志配置.go        # 日志器配置选项详解
├── 3.输出美化.go        # 美化日志输出格式
├── 4.日志前缀.go        # 自定义日志前缀
├── 5.全局日志.go        # 全局日志器使用方法
├── 6.日志双写.go        # 同时输出到多个目标
├── 7.日志分割.go        # 日志文件按大小分割
├── 8.日志等级切片.go     # 日志级别过滤和管理
├── 9.日志整合.go        # 综合示例，整合多种高级功能
├── md/                  # 详细文档目录
│   ├── 1.zap基本使用.md  # 对应示例的详细说明
│   └── ...
├── go.mod              # Go 模块定义
└── go.sum              # 依赖版本锁定
```

#### 安装教程

1. 确保已安装 Go 1.13 或更高版本
2. 克隆本仓库：`git clone https://gitee.com/your_username/go-zap.git`
3. 进入项目目录：`cd go-zap`
4. 安装依赖：`go mod download`

#### 使用说明

每个示例文件都可以独立运行，展示特定的 zap 日志库功能：

1. **基本使用**：`go run 1.zap基本使用.go` - 学习 zap 日志的基本 API 和用法
2. **日志配置**：`go run 2.日志配置.go` - 了解如何配置日志器的各种参数
3. **输出美化**：`go run 3.输出美化.go` - 美化控制台日志输出，添加颜色等
4. **日志前缀**：`go run 4.日志前缀.go` - 为日志添加自定义前缀
5. **全局日志**：`go run 5.全局日志.go` - 使用 zap 的全局日志器
6. **日志双写**：`go run 6.日志双写.go` - 同时输出日志到多个目标（文件和控制台）
7. **日志分割**：`go run 7.日志分割.go` - 实现日志文件自动分割
8. **日志等级切片**：`go run 8.日志等级切片.go` - 按级别过滤和管理日志
9. **日志整合**：`go run 9.日志整合.go` - 综合示例，展示一个完整的日志系统实现

每个示例文件都包含详细的代码注释，对应的 md 目录下有更详细的说明文档。

#### 参与贡献

1. Fork 本仓库
2. 新建分支（如：`git checkout -b feature/add-new-example`）
3. 提交代码（`git commit -m 'Add new zap feature example'`）
4. 推送至分支（`git push origin feature/add-new-example`）
5. 新建 Pull Request

#### 注意事项

- 本项目使用的 zap 版本请参考 go.mod 文件
- 运行示例时，部分示例会生成日志文件
- 请确保有适当的文件系统权限来创建和写入日志文件