Golang CBOR库推荐 - 轻量、高效、稳定，恶意数据零崩溃，支持encoding/json API及toarray/keyasint结构体标签 (fxamacker/cbor v1.3)

fxamacker/cbor 是一个优秀的CBOR编解码库，完全符合你的需求。它提供了与标准库encoding/json相同的API设计，同时具备轻量、高效、安全的特点。以下是一些关键特性及示例代码：

基本使用示例

package main

import (
    "fmt"
    "github.com/fxamacker/cbor"
)

type Person struct {
    Name string `cbor:"name"`
    Age  int    `cbor:"age"`
    City string `cbor:"city,omitempty"`
}

func main() {
    // 编码
    p := Person{Name: "Alice", Age: 30, City: "New York"}
    data, err := cbor.Marshal(p)
    if err != nil {
        panic(err)
    }
    fmt.Printf("Encoded: %x\n", data)

    // 解码
    var p2 Person
    err = cbor.Unmarshal(data, &p2)
    if err != nil {
        panic(err)
    }
    fmt.Printf("Decoded: %+v\n", p2)
}

使用keyasint标签处理COSE/CWT数据

package main

import (
    "fmt"
    "github.com/fxamacker/cbor"
)

// 使用keyasint标签处理整数键的CBOR映射
type CWTClaims struct {
    Issuer    string `cbor:"1,keyasint"`
    Subject   string `cbor:"2,keyasint"`
    Expiry    int64  `cbor:"4,keyasint"`
    IssuedAt  int64  `cbor:"6,keyasint"`
    Audience  string `cbor:"3,keyasint,omitempty"`
}

func main() {
    // 模拟CWT数据
    cwtData := []byte{
        0xa4, // map(4)
        0x01, 0x64, 0x74, 0x65, 0x73, 0x74, // 1: "test"
        0x02, 0x66, 0x61, 0x6c, 0x69, 0x63, 0x65, // 2: "alice"
        0x04, 0x1a, 0x5f, 0x2e, 0x8f, 0x00, // 4: 1597318800
        0x06, 0x1a, 0x5f, 0x2e, 0x8e, 0xc0, // 6: 1597310400
    }

    var claims CWTClaims
    err := cbor.Unmarshal(cwtData, &claims)
    if err != nil {
        panic(err)
    }
    
    fmt.Printf("Issuer: %s\n", claims.Issuer)
    fmt.Printf("Subject: %s\n", claims.Subject)
    fmt.Printf("Expiry: %d\n", claims.Expiry)
}

使用toarray标签处理紧凑数组格式

package main

import (
    "fmt"
    "github.com/fxamacker/cbor"
)

// 使用toarray标签将结构体编码为数组
type Point3D struct {
    X float64 `cbor:"0,keyasint"`
    Y float64 `cbor:"1,keyasint"`
    Z float64 `cbor:"2,keyasint"`
}

type CompactData struct {
    Name   string   `cbor:"0,keyasint"`
    Points []Point3D `cbor:"1,keyasint,toarray"`
}

func main() {
    data := CompactData{
        Name: "trajectory",
        Points: []Point3D{
            {X: 1.0, Y: 2.0, Z: 3.0},
            {X: 4.0, Y: 5.0, Z: 6.0},
        },
    }

    encoded, err := cbor.Marshal(data)
    if err != nil {
        panic(err)
    }
    
    fmt.Printf("Encoded size: %d bytes\n", len(encoded))
    
    var decoded CompactData
    err = cbor.Unmarshal(encoded, &decoded)
    if err != nil {
        panic(err)
    }
    
    fmt.Printf("Decoded: %+v\n", decoded)
}

处理恶意数据的安全示例

package main

import (
    "fmt"
    "github.com/fxamacker/cbor"
)

func main() {
    // 恶意CBOR数据示例（深度嵌套的数组）
    maliciousData := []byte{
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
        0x81, // array(1)
    }

    var result interface{}
    err := cbor.Unmarshal(maliciousData, &result)
    if err != nil {
        // fxamacker/cbor会安全地拒绝深度嵌套的恶意数据
        fmt.Printf("安全拒绝恶意数据: %v\n", err)
    } else {
        fmt.Printf("解码成功: %v\n", result)
    }
}

性能优化示例

package main

import (
    "fmt"
    "time"
    "github.com/fxamacker/cbor"
)

type SensorData struct {
    Timestamp int64     `cbor:"t"`
    Values    []float64 `cbor:"v"`
    DeviceID  string    `cbor:"d"`
}

func main() {
    // 准备测试数据
    data := SensorData{
        Timestamp: time.Now().Unix(),
        Values:    make([]float64, 1000),
        DeviceID:  "sensor-001",
    }
    
    for i := range data.Values {
        data.Values[i] = float64(i) * 0.5
    }

    // 编码性能测试
    start := time.Now()
    encoded, err := cbor.Marshal(data)
    if err != nil {
        panic(err)
    }
    encodeTime := time.Since(start)
    
    // 解码性能测试
    start = time.Now()
    var decoded SensorData
    err = cbor.Unmarshal(encoded, &decoded)
    if err != nil {
        panic(err)
    }
    decodeTime := time.Since(start)
    
    fmt.Printf("数据大小: %d bytes\n", len(encoded))
    fmt.Printf("编码时间: %v\n", encodeTime)
    fmt.Printf("解码时间: %v\n", decodeTime)
    fmt.Printf("解码验证: DeviceID=%s, Values count=%d\n", 
        decoded.DeviceID, len(decoded.Values))
}

这个库确实如描述所示，在保持与encoding/json API兼容的同时，提供了CBOR特有的功能标签（keyasint、toarray），并且在安全性和性能方面都有良好表现。编译后的二进制体积小，没有外部依赖，适合对资源敏感和对安全性要求高的场景。