zogo/snowid/README.md

snowid

基于 bwmarrin/snowflake 的雪花 ID 生成器（进程内单例）+ GORM 模型 ID 钩子模板。

用法

import "git.zeroonesoft.cn/golib/zogo/snowid"

func main() {
    if err := snowid.Init(1); err != nil { ... }      // 节点ID 0-1023
    id := snowid.Generate()                            // int64
    s := snowid.GenerateString()                       // string
}

// 生成模型（gorm.io/gen）：让 bigint 主键自动填充
// gen-model 脚本里：
opts = append(opts, gen.WithMethod(snowid.IDMethod{}))
// 生成的模型自带 BeforeCreate：Id==0 时填 snowid.Generate()

注意

• 必须先 Init 再 Generate，否则 panic（启动期暴露，不留隐患）。
• InitWithStartTime 会改全局 Epoch，须在进程首个 NewNode 前调用；同一部署里 各服务的 Epoch 口径要一致，ID 才可排序比较。
• 多实例部署时节点 ID 不得重复，否则会生成重复 ID。