Go泛型约束问题：值可比较且指针类型实现Scanner接口

错误根源 #

你定义的Scanner接口要求泛型类型本身同时满足comparable和拥有Scan(Val)方法，但你的Key类型的Scan方法是绑定在指针类型*Key上的——值类型Key并没有这个方法，因此泛型约束不匹配，触发了(method Scan has pointer receiver)错误。

解决方案 #

根据Go版本的不同，有两种清晰的解决方式：

方式一：Go 1.21+ 使用where子句（推荐） #

Go 1.21引入的where子句可以更灵活地表达泛型约束，我们可以明确指定：泛型类型K是comparable（满足map索引要求），同时*K实现Scanner接口。

修改后的代码如下：

type Key struct {
    A int
    B float64
}

func (key *Key) Scan(v Val) {
    *key = Key{int(v.A), v.B}
}

type Val struct {
    A float64
    B float64
    C float64
    // ...
}

type Scanner interface {
    Scan(Val)
}

// 使用where子句约束：K是comparable，且*K实现Scanner
func Test[K comparable](key K, val Val) where *K: Scanner {
    lookup := map[K]bool{}
    
    var key2 K
    // 取key2的指针调用Scan方法
    (&key2).Scan(val)
}

方式二：Go 1.21以下版本 适配约束接口 #

如果使用的Go版本低于1.21，没有where子句，可以通过定义一个组合约束接口，让值类型实现一个返回自身指针的方法，间接约束指针类型实现Scanner：

type Key struct {
    A int
    B float64
}

func (key *Key) Scan(v Val) {
    *key = Key{int(v.A), v.B}
}

// 让Key实现ptr方法，返回自身指针（满足KeyConstraint约束）
func (k Key) ptr() Scanner {
    return &k
}

type Val struct {
    A float64
    B float64
    C float64
    // ...
}

type Scanner interface {
    Scan(Val)
}

// 定义组合约束：K是comparable，且能返回实现Scanner的指针
type KeyConstraint interface {
    comparable
    ptr() Scanner
}

func Test[K KeyConstraint](key K, val Val) {
    lookup := map[K]bool{}
    
    var key2 K
    key2.ptr().Scan(val)
}

最佳实践 #

1. 优先使用where子句：Go 1.21+的where子句可以让泛型约束的语义更清晰，无需额外编写适配方法，是当前的最优方案。
2. 严格区分接收器类型：如果方法需要修改接收者的状态，必须使用指针接收器，不要为了满足约束强行改为值接收器（否则会导致修改仅作用于副本，逻辑出错）。
3. 确保map key的可比较性：结构体作为map key时，其所有字段必须都是comparable类型（如你的Key结构体，int和float64均满足要求），否则无法作为map索引。
4. 约束拆分明确：将“可作为map key”和“指针实现Scanner”两个需求拆分开，避免单一接口同时约束值类型的方法和属性，提升代码可读性。

内容的提问来源于stack exchange，提问作者Taco de Wolff