开源项目 `null` 使用教程

1. 项目目录结构及介绍

null 项目的目录结构如下：

null/
├── github/
│   └── workflows/
│       ├── internal
│       └── zero
├── internal/
├── zero/
├── .gitignore
├── LICENSE
├── README.md
├── bench_test.go
├── bool.go
├── bool_test.go
├── byte.go
├── float.go
├── float_test.go
├── go.mod
├── int.go
├── int16.go
├── int32.go
├── int_test.go
├── string.go
├── string_test.go
├── time.go
├── time_test.go
├── value.go
└── value_test.go

目录结构介绍

• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• internal/: 包含项目的内部实现细节，通常不对外公开。
• zero/: 包含处理零值和空值的子包。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• bench_test.go: 性能测试文件。
• bool.go: 处理布尔类型空值的实现。
• bool_test.go: 布尔类型空值处理的测试文件。
• byte.go: 处理字节类型空值的实现。
• float.go: 处理浮点数类型空值的实现。
• float_test.go: 浮点数类型空值处理的测试文件。
• go.mod: Go 模块依赖管理文件。
• int.go: 处理整数类型空值的实现。
• int16.go: 处理16位整数类型空值的实现。
• int32.go: 处理32位整数类型空值的实现。
• int_test.go: 整数类型空值处理的测试文件。
• string.go: 处理字符串类型空值的实现。
• string_test.go: 字符串类型空值处理的测试文件。
• time.go: 处理时间类型空值的实现。
• time_test.go: 时间类型空值处理的测试文件。
• value.go: 处理通用类型空值的实现。
• value_test.go: 通用类型空值处理的测试文件。

2. 项目启动文件介绍

null 项目没有传统意义上的“启动文件”，因为它是一个库项目，主要用于处理空值和零值。项目的核心功能分布在各个 .go 文件中，用户可以根据需要导入并使用这些功能。

例如，要使用 null 包中的字符串类型空值处理功能，可以在代码中导入并使用：

import "github.com/guregu/null/v5"

func main() {
    var s null.String
    s.SetValid("hello")
    fmt.Println(s.Valid) // 输出: true
}

3. 项目配置文件介绍

null 项目没有专门的配置文件，因为它是一个库项目，不依赖于外部配置。项目的功能主要通过代码导入和调用来实现。

如果需要自定义行为，可以通过代码直接修改或扩展 null 包中的功能。例如，可以通过实现自定义的 sql.Scanner 和 driver.Valuer 接口来处理特定类型的空值。

type CustomType struct {
    Value string
    Valid bool
}

func (ct *CustomType) Scan(value interface{}) error {
    if value == nil {
        ct.Value, ct.Valid = "", false
        return nil
    }
    ct.Value, ct.Valid = value.(string), true
    return nil
}

func (ct CustomType) Value() (driver.Value, error) {
    if !ct.Valid {
        return nil, nil
    }
    return ct.Value, nil
}

通过这种方式，可以扩展 null 包的功能以适应特定的需求。