Go中字符串不能直接赋值给自定义字符串类型（如type UserID string），因为Go采用名义类型系统，命名类型与底层类型虽底层相同但被视为独立类型，必须显式转换（如UserID(s)）才合法。
字符串转自定义类型时为什么不能直接赋值
Go 的字符串到自定义类型（如 type UserID string）不是自动可转换的，哪怕底层类型相同。编译器会报错 cannot use s (type string) as type UserID in assignment。这是因为 Go 的类型系统强调显式性——强类型不是“带名字的别名”，而是独立类型。
必须显式转换，且仅限于底层类型一致、无方法集冲突的情况：
-
UserID("abc123")是合法的类型转换（底层都是string） -
UserID(s)中s必须是string类型，不能是*string或其他自定义字符串类型（如type Name string） - 如果该类型实现了方法（比如
String() string），不影响转换本身，但可能影响后续 JSON 序列化逻辑
实现 json.Marshaler 接口让自定义字符串类型按需序列化
默认情况下，json.Marshal 对 type UserID string 会直接输出原始字符串（如 "u_456"）。但若你想在序列化时加前缀、脱敏或转成对象，就得实现 MarshalJSON() 方法。
常见错误是返回 nil, err 后没处理好错误路径，或误用 json.Marshal 自身导致无限递归：
立即学习“go语言免费学习笔记（深入）”；
- ❌ 错误写法：
return json.Marshal(u)→ 触发自身MarshalJSON，死循环 - ✅ 正确写法：先转回底层类型再 Marshal，例如
return json.Marshal(string(u))或return []byte(`"` + string(u) + `"`), nil - 若想输出为对象（如
{"id":"u_456"}），需构造 map 或 struct 再 Marshal，注意避免嵌套调用自身
示例：
func (u UserID) MarshalJSON() ([]byte, error) {
return json.Marshal(struct {
ID string `json:"id"`
}{ID: "user_" + string(u)})
}
UnmarshalJSON 实现必须同步处理反序列化逻辑
只实现 MarshalJSON 不够。如果 API 返回的是字符串（如 "u_789"），而你的 UnmarshalJSON 还没写，json.Unmarshal 会失败并报 json: cannot unmarshal string into Go value of type UserID。
关键点在于：反序列化时，输入可能是字符串字面量、也可能是你 MarshalJSON 输出的对象格式，得保持对称：
- 若
MarshalJSON输出字符串，则UnmarshalJSON应从[]byte解出字符串再转类型 - 若
MarshalJSON输出对象，则UnmarshalJSON需先解到临时 struct，再提取字段 - 务必检查输入是否为空或非法 JSON，返回明确错误（如
fmt.Errorf("invalid UserID: %s", data)）
示例（对应上一个 Marshal 示例）：
func (u *UserID) UnmarshalJSON(data []byte) error {
var tmp struct{ ID string }
if err := json.Unmarshal(data, &tmp); err != nil {
return err
}
if !strings.HasPrefix(tmp.ID, "user_") {
return fmt.Errorf("invalid user ID format")
}
*u = UserID(strings.TrimPrefix(tmp.ID, "user_"))
return nil
}
底层类型不同时（如 string ↔ []byte）不能直接转换
有人尝试 type HexID []byte 并希望从 string 转换，但 HexID("abc") 会编译失败：Go 不允许 string 到 []byte 的直接类型转换（即使底层兼容）。这是设计使然，防止隐式内存拷贝风险。
正确做法是显式调用构造函数或方法：
- 用
HexID([]byte(s))—— 先转[]byte，再转自定义类型 - 更安全的方式是提供工厂函数：
func NewHexID(s string) HexID { return HexID([]byte(s)) } - 若该类型要支持 JSON，
MarshalJSON通常转成 hex 字符串（hex.EncodeToString），UnmarshalJSON则用hex.DecodeString恢复，而非直接操作[]byte字面量
这点容易被忽略：类型安全边界在底层类型切换时最硬，不能靠“看起来一样”蒙混过关。
