fix: 修正 Example 函数命名与输出注释位置,让 go vet / go test 恢复可用

go vet ./... 此前有 13 处失败, 导致 go test ./...(默认带 vet)根本跑不起来,
必须加 -vet=off。这是既存问题, 与实现改动无关。

命名问题(12 处): Example 函数名的前缀必须是包内真实存在的标识符。
  ExampleStructMap_*  -> ExampleR_*         (包里没有 StructMap)
  ExampleSet_*        -> ExampleR_Set_*     (Set 是 R 的方法, 不是包级函数)
  ExampleAppend_*     -> ExampleR_Append_*  (同上)
  ExampleSchema_Unmarshal -> ExampleSchema_unmarshalJSON
                                            (Schema 没有 Unmarshal 方法,
                                             这个例子演示的是 json.Unmarshal)

输出注释位置(1 处): ExampleR_Append_typeConversionError 的 // Output: 后面
还跟着一条注释, 违反"Output 必须是最后一个注释块"。因为格式不合法, Go 一直
没把它当输出例子比对 —— 里面写的期望输出其实是错的(与实际信息不符)也没被发现。
把注释挪到 defer 之前, 并把期望输出更正为真实的 panic 信息。
已验证: 故意改错期望输出现在会导致测试失败, 说明确实在比对了。

现在 go vet ./... 干净, go test ./... 无需 -vet=off 即可运行。
This commit is contained in:
2026-08-28 17:02:56 +08:00
parent e594e206f0
commit 659fc10bae
3 changed files with 28 additions and 28 deletions
+16 -16
View File
@@ -6,8 +6,8 @@ import (
"git.fsdpf.net/go/reflux"
)
// ExampleSet_errorMessages 演示设置失败时的详细错误信息
func ExampleSet_errorMessages() {
// ExampleR_Set_errorMessages 演示设置失败时的详细错误信息
func ExampleR_Set_errorMessages() {
type Person struct {
Name string
Age int
@@ -28,8 +28,8 @@ func ExampleSet_errorMessages() {
r.Set("Age", map[string]int{"invalid": 123})
}
// ExampleSet_fieldNotFound 演示字段不存在的错误信息
func ExampleSet_fieldNotFound() {
// ExampleR_Set_fieldNotFound 演示字段不存在的错误信息
func ExampleR_Set_fieldNotFound() {
type Person struct {
Name string
Age int
@@ -48,8 +48,8 @@ func ExampleSet_fieldNotFound() {
r.Set("InvalidField", "value")
}
// ExampleSet_sliceIndexOutOfRange 演示切片索引越界的错误信息
func ExampleSet_sliceIndexOutOfRange() {
// ExampleR_Set_sliceIndexOutOfRange 演示切片索引越界的错误信息
func ExampleR_Set_sliceIndexOutOfRange() {
type Data struct {
Items []int
}
@@ -67,8 +67,8 @@ func ExampleSet_sliceIndexOutOfRange() {
r.Set("Items.10", 999)
}
// ExampleSet_unexportedField 演示未导出字段的错误信息
func ExampleSet_unexportedField() {
// ExampleR_Set_unexportedField 演示未导出字段的错误信息
func ExampleR_Set_unexportedField() {
type Person struct {
Name string
age int // 未导出字段
@@ -87,8 +87,8 @@ func ExampleSet_unexportedField() {
r.Set("age", 40)
}
// ExampleAppend_typeConversionError 演示 Append 时的类型转换错误
func ExampleAppend_typeConversionError() {
// ExampleR_Append_typeConversionError 演示 Append 时的类型转换错误
func ExampleR_Append_typeConversionError() {
type Data struct {
Items []int
}
@@ -96,19 +96,19 @@ func ExampleAppend_typeConversionError() {
d := &Data{Items: []int{1, 2, 3}}
r := reflux.New(d).Get("Items")
// 尝试追加无法转换为 int 的 map
defer func() {
if rec := recover(); rec != nil {
fmt.Println(rec)
// Output: rfx: failed to append item at index 0 to slice: cannot convert value of type map[string]int to target type int: ...
// Output: rfx: failed to append item at index 0 to slice: rfx: cannot convert, value of type map[string]int to target type int: unable to cast map[string]int{"invalid":123} of type map[string]int to int
}
}()
// 尝试追加无法转换为 int 的 map
r.Append(map[string]int{"invalid": 123})
}
// ExampleSet_nestedPathError 演示嵌套路径中的错误信息
func ExampleSet_nestedPathError() {
// ExampleR_Set_nestedPathError 演示嵌套路径中的错误信息
func ExampleR_Set_nestedPathError() {
type Address struct {
City string
}
@@ -133,8 +133,8 @@ func ExampleSet_nestedPathError() {
r.Set("Address.Country", "USA")
}
// ExampleSet_successfulTypeConversion 演示成功的类型转换
func ExampleSet_successfulTypeConversion() {
// ExampleR_Set_successfulTypeConversion 演示成功的类型转换
func ExampleR_Set_successfulTypeConversion() {
type Person struct {
Name string
Age int