默认值与验证
设置合理的默认值
默认值与验证 是 CoddyKit 上的免费 Go Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
设置合理的默认值
健壮的构造函数应从良好的默认值开始，然后允许选项覆盖它们。这样可以完全避免零值陷阱。
应用选项前先初始化
先使用默认值构建配置，然后在此基础上应用选项。
package main
import "fmt"
type Server struct {
Port int
Timeout int
}
type Option func(*Server)
func WithPort(p int) Option { return func(s *Server) { s.Port = p } }
func NewServer(opts ...Option) *Server {
s := &Server{Port: 8080, Timeout: 30}
for _, o := range opts { o(s) }
return s
}
func main() {
fmt.Printf("%+v\n", *NewServer())
fmt.Printf("%+v\n", *NewServer(WithPort(9000)))
}覆盖前默认值保持生效
不带选项调用时会得到默认值；选项只替换它涉及的字段。这兼顾了两方面的优点。
应用后进行验证
应用选项后，验证最终配置；如果配置无效，则返回错误。让构造函数返回 (*T, error)。
package main
import (
"errors"
"fmt"
)
type Server struct{ Port int }
type Option func(*Server)
func WithPort(p int) Option { return func(s *Server) { s.Port = p } }
func NewServer(opts ...Option) (*Server, error) {
s := &Server{Port: 8080}
for _, o := range opts { o(s) }
if s.Port < 1 || s.Port > 65535 {
return nil, errors.New("invalid port")
}
return s, nil
}
func main() {
_, err := NewServer(WithPort(99999))
fmt.Println(err)
}在选项内部进行验证
另一种方式是让选项本身返回错误。此时 Option 类型会变为 func(*Config) error。
package main
import (
"errors"
"fmt"
)
type Server struct{ Port int }
type Option func(*Server) error
func WithPort(p int) Option {
return func(s *Server) error {
if p < 1 {
return errors.New("port must be positive")
}
s.Port = p
return nil
}
}
func NewServer(opts ...Option) (*Server, error) {
s := &Server{Port: 8080}
for _, o := range opts {
if err := o(s); err != nil {
return nil, err
}
}
return s, nil
}
func main() {
_, err := NewServer(WithPort(-1))
fmt.Println(err)
}选择哪种验证方式
对于单个设置的检查，可以在选项内部验证；对于跨字段规则，则应在应用选项后验证（例如 TLS 要求提供证书路径）。通常两种方式会同时使用。
记录默认值
务必在构造函数的文档注释中记录每个默认值，让使用者知道省略某个选项时会得到什么。
必需值与可选值
将真正必需的值保留为位置参数；仅将真正可选的值作为选项。不要把必需数据隐藏在选项后面。
package main
import "fmt"
type Client struct {
BaseURL string
Retries int
}
type Option func(*Client)
func WithRetries(n int) Option { return func(c *Client) { c.Retries = n } }
func NewClient(baseURL string, opts ...Option) *Client {
c := &Client{BaseURL: baseURL, Retries: 3}
for _, o := range opts { o(c) }
return c
}
func main() {
fmt.Printf("%+v\n", *NewClient("https://api"))
}组合选项
您可以将多个选项组合成一个预设，用于常见配置。
package main
import "fmt"
type Server struct{ Port, Timeout int }
type Option func(*Server)
func WithPort(p int) Option { return func(s *Server) { s.Port = p } }
func WithTimeout(t int) Option { return func(s *Server) { s.Timeout = t } }
func Production() Option {
return func(s *Server) {
WithPort(443)(s)
WithTimeout(60)(s)
}
}
func NewServer(opts ...Option) *Server {
s := &Server{Port: 8080, Timeout: 30}
for _, o := range opts { o(s) }
return s
}
func main() {
fmt.Printf("%+v\n", *NewServer(Production()))
}最佳实践
- 从默认值开始，然后应用选项
- 应用后针对跨字段规则进行验证
- 将必需值保留为位置参数
- 记录每个默认值
完整而健壮的应用程序接口
将默认值、选项和验证结合起来，您就能得到一个灵活、安全、能够自我说明且易于扩展的构造函数。
快速检查
测试您对默认值和验证的掌握程度。
回顾
您完成了函数式选项模式的学习。
- 在应用选项前设置默认值
- 应用后进行验证，或在选项内部进行逐字段检查
- 将必需值保留为位置参数
- 将选项组合成预设，并记录默认值
常见问题解答
「默认值与验证」课时是免费的吗？
是的 — 「默认值与验证」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「默认值与验证」这节课中我会学到什么？
设置合理的默认值 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「默认值与验证」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。