Go.jsonvalue 项目使用教程

1. 项目的目录结构及介绍

Go.jsonvalue 是一个用于处理无结构 JSON 数据或自定义 JSON 序列化的 Go 语言库。以下是项目的目录结构及其简要介绍：

go.jsonvalue/
├── .github/         # GitHub 工作流程和配置文件
├── docs/            # 文档资料
├── img/             # 图片资源
├── internal/        # 内部使用的不对外公开的模块
├── .gitignore       # 指定 Git 忽略的文件和目录
├── CHANGELOG.md     # 项目更新日志
├── CHANGELOG_zh-cn.md # 项目更新日志（中文版）
├── LICENSE          # 项目许可证
├── README.md        # 项目说明文件
├── any_ltgo17.go    # 兼容旧版本 Go 的代码
├── codecov.yml      # CodeCov 配置文件
├── compare.go       # 比较函数实现
├── compare_test.go  # 比较函数单元测试
├── conv.go          # 数据转换函数实现
├── errors.go        # 错误处理实现
├── example_jsonvalue_test.go # 示例测试文件
├── get.go           # 获取 JSON 数据的实现
├── get_test.go      # 获取 JSON 数据的单元测试
├── go.mod           # Go 依赖管理文件
├── go.sum           # Go 依赖校验文件
├── import_export.go # 导入导出函数实现
├── import_export_test.go # 导入导出函数单元测试
├── insert_append_delete.go # 插入、追加、删除操作实现
├── insert_append_delete_must.go # 插入、追加、删除操作必须版本实现
├── insert_append_delete_test.go # 插入、追加、删除操作单元测试
├── iteration.go     # 迭代操作实现
├── iteration_test.go # 迭代操作单元测试
├── jsonvalue.go     # 核心库实现
├── jsonvalue_internal.go # 内部实现
├── jsonvalue_internal_test.go # 内部实现单元测试
├── jsonvalue_test.go # 核心库单元测试
├── serialize.go       # 序列化实现
├── serialize_test.go  # 序列化单元测试
├── serializer_deserializer.go # 自定义序列化反序列化实现
├── serializer_deserializer_test.go # 自定义序列化反序列化单元测试
├── new.go           # 创建新 JSON 对象实现
├── new_test.go      # 创建新 JSON 对象单元测试
├── option.go        # 选项配置实现
├── option_test.go   # 选项配置单元测试
├── set.go           # 设置 JSON 数据实现
├── set_must.go      # 设置 JSON 数据必须版本实现
├── set_test.go      # 设置 JSON 数据单元测试
├── sort.go          # 排序实现
├── sort_test.go     # 排序单元测试
├── deserialize.go     # 反序列化实现
└── deserialize_iter_test.go # 反序列化迭代单元测试

2. 项目的启动文件介绍

在 Go.jsonvalue 项目中，没有特定的启动文件，因为这是一个库项目，需要被其他项目引入使用。使用这个库的时候，你通常需要导入它，并使用它提供的函数来处理 JSON 数据。

例如，以下是如何使用 Go.jsonvalue 库创建和序列化一个 JSON 对象的简单示例：

package main

import (
    "fmt"
    "github.com/Andrew-M-C/go.jsonvalue"
)

func main() {
    v := jsonvalue.NewObject()
    v.MustSet("Hello, JSON").At("someObject", "someObject", "message")
    fmt.Println(v.MustSerializeString())
}

3. 项目的配置文件介绍

Go.jsonvalue 项目中的配置文件主要是 .github/workflows 目录下的 GitHub Actions 工作流文件，这些文件用于自动化项目的某些持续集成流程，例如运行测试、发布版本等。

以下是一个示例的 GitHub Actions 工作流文件的内容：

name: Test

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    - name: Set up Go
      uses: actions/setup-go@v2
      with:
        go-version: '1.15'
    - name: Install dependencies
      run: go get -t -v ./...
    - name: Run tests
      run: go test -v ./...

这个配置文件定义了一个名为 "Test" 的工作流，它在代码推送到 main 分支或对 main 分支发起 pull request 时触发。它会在最新版的 Ubuntu 虚拟环境上运行，执行检查代码、设置 Go 环境、安装依赖和运行测试的步骤。