Go 1.21+ 中 go mod init 报“unknown revision”主因是 GOPROXY 失效或缓存损坏，推荐设为清华源；graphql-go 适合教学，gqlgen 更适合中大型项目；gqlgen 需正确配置 resolver 路径并手动补全方法；Playground 需显式注册，CORS 需谨慎配置。
Go 1.21+ 安装后 go mod init 报错 “unknown revision”
常见原因是 GOPROXY 默认值在某些网络环境下失效，或本地缓存损坏。直接执行 go env -w GOPROXY=https://proxy.golang.org,direct 可能仍失败——国内更稳的方案是切到清华源：go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/go/。若项目已有 go.mod 且依赖拉取失败，先删掉 go.sum 和 vendor/（如有），再运行 go mod tidy。
用 graphql-go/graphql 还是 99designs/gqlgen？
前者是纯手工构建 schema 的轻量库，适合教学或极简原型；后者是代码生成型框架，强制约定文件结构，适合中大型服务。新手常误以为“先跑通就行”，结果在 graphql-go 里手动拼 graphql.NewObject 时字段类型写错（比如把 graphql.String 写成 graphql.StringType），导致服务启动 panic。推荐起步用 gqlgen：它通过 schema.graphql 文件自动生成 resolver 接口，编译期就能发现类型不匹配。
gqlgen init 后修改 schema 但 gqlgen generate 不更新 resolver
根本原因不是命令没执行，而是 gqlgen.yml 中的 resolver 配置路径与实际文件位置不一致。检查该配置项是否指向了正确的 Go 包路径（如 resolver: ./graph/resolver.go），同时确认 resolver.go 里结构体是否实现了生成的接口（例如 QueryResolver）。另一个坑是：新增字段后忘记在 resolver.go 中补对应方法，gqlgen generate 不会报错，但运行时 GraphQL 查询该字段会返回 null 且无日志提示。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
服务跑起来但 Playground 返回 404 或 CORS 被拒
默认 gqlgen 生成的服务只暴露 GraphQL endpoint（如 /query），不带 Playground 页面。要启用，需手动注册 handler：http.Handle("/", handler.Playground("GraphQL playground", "/query"))，并确保路由顺序——Playground 的 / 必须在 /query 之后注册，否则被覆盖。CORS 问题通常因前端调用时 origin 不匹配，简单起见可临时加中间件：http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Access-Control-Allow-Origin", "*"); ... })。生产环境必须限制 origin，且注意 Access-Control-Allow-Credentials: true 不能和 * 共存。
立即学习“go语言免费学习笔记（深入）”；
GraphQL 的 schema 设计和 resolver 实现耦合度高，改一个字段类型往往要同步动三处：schema 文件、generated Go 接口、你写的 resolver 方法。最容易漏的是 generated 接口里的函数签名——IDE 不会自动补全，得靠gqlgen generate 后手动核对。 
