必须使用 terraform-plugin-sdk/v2，因其封装 gRPC 桥接、schema 注册等核心逻辑，v1 已弃用；字段需用指针类型处理空值，默认值才生效；Schema 键名须与 HCL 完全一致，类型拼写要准确；日志须用 resp.Diagnostics 或 log.Printf 配合 TF_LOG。
为什么不用 terraform-plugin-sdk2 就会编译失败
Go 编写的 Terraform Provider 必须依赖官方 SDK，否则 terraform init 会报 plugin failed to start 或直接静默退出。v1 版本已弃用，v2 是当前唯一受支持的基线——它封装了 gRPC 协议桥接、schema 注册、state 生命周期等底层逻辑。
- 不引入
github.com/hashicorp/terraform-plugin-sdk/v2，连最基础的provider.NewProvider都无法构造 - 若误用
github.com/hashicorp/terraform-plugin-sdk（无 /v2 后缀），Go mod 会拉取已归档的 v1，导致ResourceSchema等类型缺失 - v2 要求 Go 版本 ≥ 1.18；低于此版本会卡在
go:embed或泛型语法上
resource.Create 函数里怎么处理空值和默认值
Terraform 的 HCL 配置中字段可选，但 Go struct 字段若为非指针基础类型（如 int、string），零值会被当成显式赋值，覆盖 schema 中定义的 Default 或 Optional: true 行为。
- 所有可选字段必须声明为指针类型：
*string、*int64，否则plan.GetAttr("name")读不到 nil 判断依据 - 在
Create函数开头用if v, ok := plan.GetAttr("timeout"); ok && v.IsKnown() && !v.IsNull()判断是否真有值，不能只靠v.String() - 调用外部 API 前，对指针字段做安全解引用：
timeout := 30；if d.Timeout != nil {timeout = int(*d.Timeout) }
如何让 terraform validate 不报 schema 类型不匹配
常见错误是把 Type: schema.TypeString 写成 Type: schema.TypeString（少了个 s），或在 Schema map 里键名拼错，导致 terraform validate 提示 Invalid value for module argument。
-
schema.TypeString是正确写法；schema.TypeString是不存在的标识符，编译能过但运行时 panic - resource 的
Schema字段必须是map[string]*schema.Schema类型，键名必须与 HCL 中字段名完全一致（包括大小写） - 嵌套 block（如
dynamic或set）要用&schema.Schema{Type: schema.TypeList, Elem: &schema.Resource{……}}，不能漏掉Elem - 测试时先跑
terraform validate -no-color，比apply更早暴露 schema 定义问题
调试 provider.Run 时看不到日志怎么办
go run 启动 provider 进程后，标准输出被 Terraform 主进程接管，直接 fmt.Println 无效。必须用 SDK 提供的日志接口，且需开启 TF_LOG 环境变量。
立即学习 “go 语言免费学习笔记（深入）”；
- 在
Create/Read函数里用resp.Diagnostics.AddError("msg", "detail")，这是唯一进terraform apply输出的错误路径 - 调试信息用
log.Printf("[DEBUG] %s", msg)，但需提前设置TF_LOG=DEBUG，否则全被过滤 - 避免在
Configure函数里打日志——它可能被多次调用，且上下文未就绪，容易 panic - 真实调试建议加断点：用
dlv debug --headless --listen=:2345 --api-version=2 --accept-multiclient，再 attach 到子进程
真正难的不是写完第一个 resource，而是让每个字段的 null/unknown/known 状态在 plan/apply/read 三阶段里保持语义一致——这需要反复看 terraform show -json 输出的 state 结构，而不是只盯着 Go 代码。
