go模块升级必须显式使用/v2路径后缀并调整目录结构和import路径，否则构建失败；协议迁移需双协议共存、protobuf变更遵守wire兼容规则，连接池与健康检查等配置须随协议重审。
不能靠“无缝替换”蒙混过关。Go 模块升级通信协议时，只要接口签名、序列化格式或传输语义变了，调用方就必然感知——所谓“无感知”，只存在于协议兼容层设计得当、且所有依赖方同步适配的前提下。
go.mod 中主版本升级必须显式带 /v2 路径后缀
如果你要把 github.com/yourorg/comm 从 v1 升级到 v2（比如把 JSON-RPC 换成 gRPC over HTTP/2），模块路径必须改成 module github.com/yourorg/comm/v2，且代码必须放在 /v2/ 子目录下。
常见错误是只改 go.mod 里的 module 行，不调整目录结构和 import 路径——结果 go build 直接报 cannot find package "github.com/yourorg/comm"，因为 Go 会按新路径去找包，而源码里还是老 import。
- 所有调用方的
import必须批量替换成github.com/yourorg/comm/v2 -
go mod tidy会更新require，但不会动 import，这步必须手动或用gofmt -r脚本处理 - 旧版本用户完全不受影响：
go get github.com/yourorg/comm拿到的仍是 v1，除非显式写@v2
协议迁移需保留双协议共存能力
真正实现“无感知”不是靠跳过兼容，而是让新旧协议并行跑一段时间。比如你把 HTTP JSON 接口升级为 gRPC，但老客户端还在用，就不能直接删掉 REST handler。
典型做法是在同一服务中同时暴露两种 endpoint：
- HTTP handler 继续接收
POST /api/v1/measure，内部转成 gRPC client 调用新协议后端 - 新增
POST /api/v2/measure或 gRPC methodMeasureV2，直连新逻辑 - 用
viper.GetString("comm.protocol")控制路由开关，便于灰度切流
注意：别在 gRPC server 里硬塞 JSON 解析逻辑——协议边界要清晰，否则后续维护成本爆炸。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
Protobuf schema 变更必须遵守 wire 兼容性规则
如果你用 Protobuf 定义通信结构（比如 sensor.proto），字段增删改都直接影响 wire 格式。哪怕只是加个 optional 字段，旧 client 解析新 message 也可能 panic。
关键约束：
- 只能用
optional或repeated新增字段，不能改已有字段的field number - 删除字段前，先标
deprecated = true，等下游全部升级后再移除 - 枚举值新增必须用新数字，不能复用旧值；
0必须是默认值（如UNKNOWN = 0） - 生成 Go 代码时，确保两端用相同版本的
protoc-gen-go，否则XXX_Unmarshal行为可能不一致
连接池与超时配置必须随协议重审
从 HTTP/1.1 切到 gRPC over HTTP/2，底层连接复用模型完全不同。原来基于 http.Transport 的长连接池、idle timeout、keep-alive 设置，对 gRPC client 完全失效。
例如：
- gRPC 默认启用
KeepaliveParams，但若 Sidecar（如 Envoy）没配好max_connection_age，会导致连接被静默断开 - HTTP client 的
Timeout是整请求耗时上限；gRPC 的context.WithTimeout控制单次 RPC，还需设PerRPCTimeout防止流式调用卡死 - Unix socket 场景下，gRPC dialer 必须显式传
grpc.WithTransportCredentials(insecure.NewCredentials())，否则因 TLS handshake 失败静默失败
最容易被忽略的是健康探测逻辑——原来用 HEAD /healthz 检查 HTTP 服务是否 ready，换成 gRPC 后得改用 grpc_health_v1.Health.Check，否则 readiness probe 总是失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
