Go结构体tag触发reflect.StructTag.Get语法错误告警排查

已查阅相关StackOverflow帖子，但其中描述的问题和当前场景不一致。
自行实现简易JSON编码函数时，代码可正常运行输出预期结果，但VS Code弹出静态检查告警：

Struct field tag name not compatible with reflect.StructTag.Get: bad syntax for struct tag pair

测试代码如下：

package main

import (
	"bytes"
	"fmt"
	"reflect"
	"strconv"
	"strings"
)

type User struct {
	Name string `name`
	Age  int64  `age`
}

func main() {
	var u User = User{"bob", 10}

	res, err := JSONEncode(u)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(res))

}

func JSONEncode(v interface{}) ([]byte, error) {
	refObjVal := reflect.ValueOf(v)
	refObjTyp := reflect.TypeOf(v)
	buf := bytes.Buffer{}
	if refObjVal.Kind() != reflect.Struct {
		return buf.Bytes(), fmt.Errorf(
			"val of kind %s is not supported",
			refObjVal.Kind(),
		)
	}
	buf.WriteString("{")
	pairs := []string{}
	for i := 0; i < refObjVal.NumField(); i++ {
		structFieldRefObj := refObjVal.Field(i)
		structFieldRefObjTyp := refObjTyp.Field(i)

		switch structFieldRefObj.Kind() {
		case reflect.String:
			strVal := structFieldRefObj.Interface().(string)
			pairs = append(pairs, `"`+string(structFieldRefObjTyp.Tag)+`":"`+strVal+`"`)
		case reflect.Int64:
			intVal := structFieldRefObj.Interface().(int64)
			pairs = append(pairs, `"`+string(structFieldRefObjTyp.Tag)+`":`+strconv.FormatInt(intVal, 10))
		default:
			return buf.Bytes(), fmt.Errorf(
				"struct field with name %s and kind %s is not supprted",
				structFieldRefObjTyp.Name,
				structFieldRefObj.Kind(),
			)
		}
	}

	buf.WriteString(strings.Join(pairs, ","))
	buf.WriteString("}")

	return buf.Bytes(), nil
}

代码运行输出：

{"name":"bob","age":10}

告警截图：

这个告警是Go自带的vet静态检查工具触发的语法规范提示，不影响当前代码的运行结果，核心原因是结构体标签写法不符合Go官方定义的语法规则：

• Go标准库reflect.StructTag明确约定，结构体标签必须遵循key:"value"的键值对格式：key后必须紧跟冒号，取值需要用双引号包裹，不支持仅写裸key的形式。
• 代码中结构体标签直接写了name、age，没有遵循上述格式。虽然直接将整个tag内容转为字符串读取时能拿到对应值，运行逻辑正常、输出结果正确，但写法不符合标签语法约定，因此静态检查会抛出该告警。

• 推荐方案：将标签改为符合规范的格式，示例如下：

type User struct {
	Name string `json:"name"`
	Age  int64  `json:"age"`
}

同步将读取标签的逻辑改为调用标准方法structFieldRefObjTyp.Tag.Get("json")获取值，既符合Go通用编码规范、消除告警，也和标准库encoding/json的序列化逻辑保持一致。

• 不推荐方案：如果不想改动现有逻辑，可以在VS Code的Go插件配置中关闭structtag对应的检查项，但这种写法不符合Go编码规范，后续调用标准标签解析方法时会出现取值失败的问题。

内容的提问来源于stack exchange，提问作者Hasan A Yousef