Go版本管理与向后兼容性

Go模块系统遵循语义化版本规范，确保向后兼容性。

语义化版本规范

版本号格式

vMAJOR.MINOR.PATCH

MAJOR：主版本（不兼容变更）
MINOR：次版本（兼容新增功能）
PATCH：补丁版本（兼容bug修复）

示例：
v1.0.0 → v1.0.1（补丁）
v1.0.1 → v1.1.0（新增功能）
v1.1.0 → v2.0.0（不兼容变更）

版本变更规则

go.mod版本管理

基本结构

module github.com/user/mylib

go 1.22

require (
    github.com/other/lib v1.2.3
    golang.org/x/tools v0.15.0
)

版本引用规则

// 最小版本选择
require (
    github.com/other/lib v1.2.3  // 最小满足的版本
)

// indirect间接依赖
require (
    github.com/indirect/lib v1.0.0 // indirect
)

接口兼容性策略

添加方法（兼容）

// v1.0.0
type Reader interface {
    Read(p []byte) (int, error)
}

// v1.1.0（兼容）
type Reader interface {
    Read(p []byte) (int, error)
    ReadAll() ([]byte, error)  // 新增方法
}
// 问题：已有实现者不满足新接口

解决：定义新接口

// v1.1.0
type Reader interface {
    Read(p []byte) (int, error)
}

type FullReader interface {
    Reader
    ReadAll() ([]byte, error)
}

// 使用者按需要选择接口

删除方法（不兼容）

// v1.0.0
type Handler interface {
    Handle()
    Process()
}

// v2.0.0（不兼容）
type Handler interface {
    Handle()  // 删除Process
}
// 必须：升级MAJOR版本

向后兼容实践

1. 新增功能用新接口

// v1.x 保持原有接口不变
type OldInterface interface {
    Method1()
}

// 新增功能定义新接口
type NewInterface interface {
    OldInterface
    Method2()
}

2. 不修改现有方法签名

// 不推荐：修改签名（不兼容）
func Process(data string) error
func Process(data []byte) error  // 签名变更

// 推荐：新增方法
func ProcessString(data string) error
func ProcessBytes(data []byte) error

3. 保留废弃方法

// v1.x
func OldMethod() {
    // Deprecated: 使用NewMethod替代
}

func NewMethod() {
    // 新实现
}

// 保留OldMethod一段时间后再删除

依赖升级管理

更新依赖

# 更新到最新patch
go get github.com/user/lib@v1.2.x

# 更新到特定版本
go get github.com/user/lib@v1.3.0

# 更新所有依赖
go get -u

主版本升级

// v1和v2是不同模块路径
require (
    github.com/user/lib v1.2.3
    github.com/user/lib/v2 v2.0.0  // 路径带/v2
)

// 可同时使用不同主版本

接口演进示例

兼容演进（MINOR）

// v1.0.0
package mylib

type Service interface {
    Do() error
}

// v1.1.0（兼容）
package mylib

type Service interface {
    Do() error
}

// 新接口，不影响Service
type AdvancedService interface {
    Service
    DoAdvanced() error
}

不兼容演进（MAJOR）

// v1.0.0
package mylib

type Service interface {
    Do() error
    Process() error  // 将删除
}

// v2.0.0（不兼容）
package mylib/v2

type Service interface {
    Do() error  // 删除Process
}

版本兼容检查表

要点总结

• 语义化版本：MAJOR.MINOR.PATCH
• PATCH兼容修复，MINOR兼容新增，MAJOR不兼容
• 新增方法定义新接口而非修改原接口
• 不修改现有方法签名
• 废弃方法保留一段时间再删除
• 主版本升级使用/vN路径
• go.mod管理依赖版本
• 最小版本选择确保稳定