Go reflect判断类型转换与断言边界的参数对比

在通用解码、字段映射或插件参数处理中，最容易混淆的是“能不能转换”“能不能直接赋值”和“接口里是不是这个类型”。Go reflect 把这三件事拆成了不同的判断：ConvertibleTo 面向语言转换规则，AssignableTo 面向赋值兼容，类型断言面向接口中的动态类型。先判断目标动作，再选对应 API，才能避免把可转换的值直接交给 Set，或者把类型断言当成数值转换。

先把转换、赋值和断言分成三条路径

可以先用动作来分类。目标是得到另一种类型的值，例如把 int64 转成自定义的 OrderID，这是转换；目标是把一个已有的 reflect.Value 写进字段，这是赋值；目标是从 any 中取出实现了某个接口的动态值，这是断言。

这张表的关键在于：AssignableTo 不会替你完成转换，ConvertibleTo 也不保证值可以直接写入目标。反射代码里最好把“检查”和“动作”放在同一个小函数中，让失败路径可读。

用 ConvertibleTo 与 CanConvert 守住数值和命名类型转换

命名类型经常让判断出现错觉。下面的 int64 与 OrderID 底层表示相关，但它们不是同一个类型；如果目标是产生一个新的 OrderID，应该先判断可转换性，再调用 Convert。

package main

import (
    "fmt"
    "reflect"
)

type OrderID int64

func main() {
    // 目标是生成新的 OrderID，而不是直接改写一个已有字段。
    src := reflect.ValueOf(int64(1024))
    dstType := reflect.TypeOf(OrderID(0))

    // CanConvert 与 Convert 配对，避免把非法转换直接交给反射。
    if !src.CanConvert(dstType) {
        fmt.Println("cannot convert")
        return
    }
    converted := src.Convert(dstType)
    fmt.Println(converted.Type(), converted.Interface())
}

这里的检查回答的是“能否按 Go 的转换规则产生目标类型”，不是“能否把源值写入某个字段”。对于切片转数组指针等依赖长度的转换，官方文档也提示即使 ConvertibleTo 为真，实际转换仍可能因为运行时条件不满足而 panic；需要额外检查长度或用可恢复的错误边界。

如果你的输入来自 reflect.ValueOf(nil)，先检查 IsValid；无效值没有可用类型，不能直接调用 Type、CanConvert 或 Convert。

用 AssignableTo 与 CanSet 完成安全写入

Set 的语义是赋值，不是隐式转换。下面让一个实现了 fmt.Stringer 的命名字符串值写入接口字段：源类型对目标接口可赋值，目标字段也必须来自可设置的结构体值。

package main

import (
    "fmt"
    "reflect"
)

type Label string

func (l Label) String() string { return string(l) }

type Record struct {
    Value fmt.Stringer
}

func main() {
    // 取指针再 Elem，得到可寻址、可设置的结构体值。
    record := reflect.ValueOf(&Record{}).Elem()
    field := record.FieldByName("Value")
    source := reflect.ValueOf(Label("ready"))

    // Set 只接受可赋值的源值，不能因为底层类型相近就直接写入。
    if !field.CanSet() || !source.Type().AssignableTo(field.Type()) {
        fmt.Println("value is not assignable")
        return
    }
    field.Set(source)
    fmt.Println(record.Interface())
}

如果源值只是“可转换”而不是“可赋值”，正确顺序是先确认 CanConvert，得到转换后的 Value，再重新判断转换结果是否能赋给字段。不要把 Convert 和 Set 合并成一个无条件链式调用，因为转换成功仍不代表目标字段接受该值。

另外，CanSet 为假不只表示目标没有地址；从未导出字段取得的值也不能被设置。反射工具遇到这类字段时应返回错误，别用 panic 当作业务分支。

把接口断言放回动态值边界

接口断言检查的是接口里携带的动态值是否满足目标类型。例如 Label 实现了 fmt.Stringer，所以从 any 中断言为 fmt.Stringer 可以成功；这不是把 Label 转换成另一个具体类型。

package main

import "fmt"

type Label string

func (l Label) String() string { return string(l) }

func readText(input any) (string, bool) {
    // 逗号 ok 形式把动态类型不匹配变成可处理的分支。
    text, ok := input.(fmt.Stringer)
    if !ok || text == nil {
        return "", false
    }
    return text.String(), true
}

在支持泛型反射断言的 Go 版本中，也可以使用 reflect.TypeAssert[T](v)；它的语义仍是接口断言，不会替你执行数值转换。要判断 int64 能否变成 OrderID，仍然回到 CanConvert 与 Convert。两条路径的失败原因不同，日志和错误信息也应分别描述。

用一张决策表固定工程写法

反射工具可以把判断顺序固定为“值是否有效 → 目标动作 → 类型关系 → 值操作”。目标是新值时走转换；目标是已有字段时走赋值；目标是接口语义时走断言。若转换或赋值失败，返回包含源类型和目标类型的错误，便于定位。

复查时重点看三个边界：是否把 Kind 相同误当成类型可赋值，是否漏掉 CanSet，以及是否把断言失败当成可以转换。把这三项拆开，反射代码会更接近普通 Go 代码的类型规则，也更容易测试。

常见问题

ConvertibleTo 为真就一定能调用 Set 吗

不一定。它只说明可以按转换规则产生目标类型；Set 要求源值对目标类型可赋值，通常需要先得到转换后的值并再次判断。

AssignableTo 为真还会在 Set 时失败吗

会。目标值还必须 CanSet，并且不能来自未导出字段；写入前应同时检查这两个条件。

什么时候用类型断言而不是反射转换

当值位于接口中，且你要确认它是否实现某个接口或是否为某个具体动态类型时使用断言；需要改变值的类型表示时才使用转换。