goland需手动将.graphqls后缀注册为graphql类型：在settings→editor→file types中为graphql添加*.graphqls模式，确保无其他类型抢占该后缀，重启ide后即可启用语法校验。
GraphQL插件在GoLand里不校验schema.graphqls怎么办
GoLand自带的GraphQL插件默认只识别 .graphql 或 .gql 后缀文件，对 schema.graphqls（gqlgen 默认命名）完全无感知——它压根不会加载语法高亮、字段跳转或错误提示。
必须手动注册后缀映射：
- 打开 Settings → Editor → File Types
- 找到 GraphQL 类型，在 Registered Patterns 下添加
*.graphqls - 确认没有其他类型（如 Text）抢先占用了该后缀，否则优先级冲突会导致失效
改完后重启 GoLand，再打开 schema.graphqls 就能看见字段名标红、未定义类型报错、括号自动匹配等基础校验了。
为什么Schema里写了type User但Go代码里没生成对应model
不是插件问题，是 gqlgen 生成流程断在了前一步：GoLand 的 GraphQL 插件只做静态语法/结构校验，它不读 gqlgen.yml，也不触发代码生成。你看到的 “User 未定义” 提示，只是插件发现 schema 里声明了 type User，但在当前文件中没找到对应定义——它并不知道这个 type 应该由 gqlgen generate 输出到 graph/model/user.go。
真正要让 model 出现，得跑命令：
- 确保已执行过
go run github.com/99designs/gqlgen generate - 检查
gqlgen.yml中models配置是否覆盖了User，例如：models: User: model: github.com/your/app/graph/model.User - 生成后若仍看不到
model.User跳转，右键项目 → Reload project，强制 GoLand 重新索引 Go 文件
Schema字段名大小写和Go导出字段不匹配导致resolver编译失败
GraphQL 字段名是小驼峰（userName），Go 结构体字段必须是大驼峰（UserName）且导出，否则 gqlgen generate 生成的 resolver 接口会要求你实现一个根本不存在的字段方法，编译直接报 missing method。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
常见错配场景：
- schema 写
user_name: String!，Go 里却用UserName string→ 字段名不一致，生成器忽略该字段 - schema 写
userName: String!，Go 里写username string（小写）→ 非导出字段，序列化为空，resolver 接口也收不到该字段声明 - resolver 方法签名漏了
ctx context.Context参数 → 编译报cannot use ... as graphql.QueryResolver.Users value in assignment
解决方式只有两个：严格按 gqlgen 的命名映射规则来；所有业务逻辑只写在 resolver.go 方法体内部，别动函数签名——那部分每次 generate 都会被覆盖。
GraphQL插件报“Unknown directive @auth”但服务能正常运行
这是预期行为，不是 bug。GoLand 插件内置的 GraphQL 语言服务基于 graphql-js 的 SDL 验证逻辑，默认只认标准指令（@include、@skip、@deprecated），不认识自定义指令如 @auth、@hasRole。
不影响运行，因为：
-
gqlgen在解析时默认忽略未知指令（除非显式配置directive处理逻辑） -
graphql-go/graphql.ParseQuery也跳过未知 directive，只做语法校验 - 真实校验发生在 resolver 执行期，比如在
User(ctx, args)开头手动检查ctx.Value("auth") != nil
如果想消除警告，可在 schema 顶部加一行注释告诉插件忽略：
# graphql-disable-next-line unknown-directive
type Query { user(id: ID!): User @auth }。但更推荐留着这个提示——它反而是个信号：说明你有未被插件识别的扩展逻辑，上线前得人工核对是否真有对应 resolver 拦截。
