使用 milvus-sdk-go/v2 是连接 Milvus 2.x 的唯一稳定方式，需 Go ≥ 1.18、显式调用 Connect()、AutoID 与 PrimaryKey 必须匹配、插入后须 CreateIndex 再 LoadCollection。
用 milvus-sdk-go 连接 Milvus 2.x 是当前唯一稳定选择
Go 官方只维护 milvus-sdk-go，对应 Milvus 2.0+（即基于 Pulsar/MinIO 的新版），不支持已归档的 Milvus 1.x。如果你看到旧教程调用 github.com/milvus-io/milvus-sdk-go/v2 以外的包，基本是过时或非官方分支，连不上最新版服务。
安装命令就是：
go get github.com/milvus-io/milvus-sdk-go/v2
- 务必用
v2后缀，v1或无版本号会拉取错误分支 - SDK 要求 Go ≥ 1.18；低于该版本可能编译失败，报错类似
cannot use ~string as string - Milvus 服务端必须开启 gRPC 端口（默认
19530），HTTP 端口（19121）仅用于健康检查和 Metrics，SDK 不走 HTTP
初始化 client 前必须显式调用 client.Connect()
不同于很多 Go SDK 自动连接，milvus-sdk-go 的 client 构造函数只做配置解析，不发起网络请求。漏掉 Connect() 会导致后续所有操作 panic，错误信息通常是：
panic: runtime error: invalid memory address or nil pointer dereference，实际根源是 client 内部的
grpcClient 为 nil。
- 正确写法：
ctx := context.Background() c, err := client.NewClient(ctx, client.Config{ Address: "localhost:19530", }) if err != nil { log.Fatal(err) } // 必须手动 connect err = c.Connect(ctx) if err != nil { log.Fatal(err) } -
Connect()是同步阻塞调用，超时由传入的ctx控制；建议设ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) - 连接成功后无需手动管理连接池——SDK 内部复用 gRPC 连接，重复
Connect()会报already connected
创建 collection 时 AutoID 和 PrimaryKey 字段必须匹配
这是新手最常踩的坑：定义 schema 时设了 AutoID: true，却没把某个字段同时标记为 PrimaryKey: true，结果 CreateCollection() 直接返回错误：
invalid parameter: primary key field must be specified when auto id is enabled
立即学习“go语言免费学习笔记（深入）”；
- Milvus 强制要求：启用自增 ID（
AutoID: true）时，必须且只能有一个字段同时满足IsPrimaryKey: true且类型为Int64 - 常见误配：
IsPrimaryKey: true但类型是FloatVector，或两个字段都设了IsPrimaryKey: true - 示例正确 schema：
schema := &entity.Schema{ CollectionName: "demo", Description: "demo collection", AutoID: true, Fields: []*entity.Field{ { Name: "id", DataType: entity.Int64, IsPrimaryKey: true, AutoID: true, }, { Name: "vector", DataType: entity.FloatVector, TypeParams: map[string]string{"dim": "128"}, }, }, }
插入向量前必须先 CreateIndex() 并 LoadCollection()
刚建完 collection 就调 Insert() 通常能成功，但紧接着查不到结果或 Search() 报空结果——因为数据还在内存缓冲区，没构建索引也没加载到查询节点。Milvus 不像关系库那样“写即可见”，它分三步：写入 → 建索引 → 加载。
-
CreateIndex()必须在Insert()**之后**调，参数中的field名要和 vector 字段名完全一致（区分大小写） -
LoadCollection()必须在CreateIndex()**完成之后**调，否则Search()返回空；可用c.HasCollection()和c.GetLoadState()检查状态 - 完整流程顺序不能乱：
_, err := c.Insert(ctx, "demo", "", vectors, ids) if err != nil { ... } _, err = c.CreateIndex(ctx, "demo", "vector", idx, false) if err != nil { ... } err = c.LoadCollection(ctx, "demo", false) if err != nil { ... }
跳过建索引或加载，Search() 可能不报错但永远返回空切片；而 GetPersistentSegmentInfo() 可以确认数据是否真正落盘。
