0Pricing
Go Academy · 课时

验证库

使用标签验证结构体

验证库 是 CoddyKit 上的免费 Go Academy 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

为什么要验证结构体

在使用传入的数据(来自表单或 API)之前,您通常必须检查这些数据:必填字段、有效的电子邮件地址以及值的范围。验证库使用结构体标签自动完成这些工作。

validate 标签

像 go-playground/validator 这样的常用库会读取 validate 标签,该标签描述每个字段的规则。

字段可能带有 validate:"required,email"。

外部依赖

验证库是第三方软件包,不属于标准库。您可以使用 go get github.com/go-playground/validator/v10 添加它们。不过,它们无法在这里的独立代码片段中运行。

定义规则

每个字段的 validate 标签都会列出规则,规则之间用逗号分隔。常见规则包括:required、email、min、max 和 len。

结构体示例

这是一个典型的经过验证的结构体。(概念性示例;运行它需要验证器软件包。)

type SignupForm struct {
	Email    string "validate:\"required,email\""
	Password string "validate:\"required,min=8\""
	Age      int    "validate:\"gte=18,lte=120\""
}

执行验证

您需要创建一个验证器实例,然后调用 Validate.Struct(form)。如果任何规则验证失败,它会返回一个错误;如果全部通过,则返回 nil。

import "github.com/go-playground/validator/v10"

var validate = validator.New()

func check(f SignupForm) error {
	return validate.Struct(f)
}

读取错误

验证失败时,可以将返回的错误转换为 validator.ValidationErrors。它是一个切片,用于描述每条未通过的规则,包括哪个字段以及哪个约束未通过。

常用内置规则

实用的规则包括:

  • required - 不能是零值
  • email - 必须符合有效的电子邮件格式
  • min / max - 长度或数值范围限制
  • gte / lte - 数值比较
  • oneof - 必须是列表中的某个值

验证嵌套结构体

验证器会自动递归处理嵌套结构体。如果某个字段本身是结构体,也会检查其中定义的规则,因此一次调用就能验证整个对象图。

为什么使用库

为每个字段手写验证逻辑既繁琐又容易出错。标签驱动的验证方式让规则以声明式形式存在于字段旁边,并确保整个应用中的规则保持一致。

手动实现

对于简单情况,您可以不使用库而手动进行验证;但字段较多且规则复杂时,使用库更合适。这种方式只使用标准库,因此可以在任何地方运行。

package main

import (
	"errors"
	"fmt"
	"strings"
)

func validateEmail(e string) error {
	if !strings.Contains(e, "@") {
		return errors.New("invalid email")
	}
	return nil
}

func main() {
	fmt.Println(validateEmail("bad"))
	fmt.Println(validateEmail("a@b.com"))
}

快速检查

像 go-playground/validator 这样的验证库,是如何知道应为每个字段应用哪些规则的?

回顾

验证库:

  • 读取 validate 标签并应用规则
  • 属于第三方库(例如 go-playground/validator),通过 go get 添加
  • 返回错误,其中列出每条未通过的规则
  • 简单情况可以手动验证

常见问题解答

「验证库」课时是免费的吗?

是的 — 「验证库」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Go Academy 课程的其余内容,请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「验证库」这节课中我会学到什么?

使用标签验证结构体 你通过在浏览器中直接运行的动手代码来练习 Go Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 3 节课,共 4 节。

「验证库」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗?

能。每节 Go Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 什么是结构体标签
  2. JSON 标签
  3. 验证库
  4. 自定义标签解析
← 返回 Go Academy