goland 无法自动生成外键关联图，仅支持基于显式或手动配置的虚拟外键生成图表；join 子句、orm tag 或 go 代码中的关系均不被识别。

GoLand 不能自动从 SQL 或 Go 代码中“推断并生成”外键关联关系图——它只识别显式定义的外键（含虚拟外键），且图表需手动触发生成。 没有开关能一键扫描整个数据库或项目，让 IDE 自动补全所有 JOIN 关系并画出完整 ER 图。

为什么“自动生成”不成立：外键必须显式存在或手动声明

GoLand 的数据库图表功能依赖真实或虚拟的外键元数据。它不会解析 JOIN 子句中的字段名匹配（比如 ON a.user_id = b.id）来反推关系，也不会读取 GORM/Ent 的 struct tag 或 Go 代码里的 edge.From 声明。

• 显式外键：建表语句中带 FOREIGN KEY (...) REFERENCES ...，GoLand 会自动识别并用于图表、补全、导航
• 虚拟外键：仅存在于 IDE 配置文件 external-data-<data_source_name>.xml</data_source_name> 中，需手动创建，不改变数据库结构
• 无外键时：即使 SQL 里写了 JOIN，图表中两个表默认是孤立节点，不会连线

如何让两张表在图表中真正连上线

必须先建立可被识别的关系，再生成图表：

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 在数据库中执行 ALTER TABLE ... ADD CONSTRAINT ... FOREIGN KEY —— 最可靠，所有功能（补全、导航、图表）都生效
• 若无法改库（如用 ClickHouse/Cassandra），右键目标表 → 新建 | 虚拟外键，填入子表列名（如 user_id）和目标表主键列名（如 id）
• 确保目标表有主键（或唯一索引）：GoLand 只认主键/唯一约束作为外键引用目标，否则虚拟外键保存失败
• 保存后，在数据库工具窗口中右键该表或数据源 → 图表 | 显示图表，连线才会出现

图表导出与常见卡点

生成的图表默认是交互式 UML 格式，不是 PNG：

• 导出为图片：右键图表 → 导出图表 | 导出为图像 → 选 PNG；UML 格式（.uml）仅 GoLand 能打开，别误存为共享用途
• 图中连线消失？检查是否禁用了 diagrams 插件：按 Ctrl+Alt+S → 插件 → 确保 Database Tools and SQL 和 Diagrams 均已启用
• 表太多导致图表糊成一团？先右键数据源 → 过滤器，勾选“仅显示有外键关系的表”，或手动拖拽缩放（Shift + 鼠标滚轮）
• 虚拟外键没生效？确认 XML 文件路径没被写错：进数据源设置 → 选项 → “虚拟对象和特性”字段，路径应指向可写目录

真正容易被忽略的是：虚拟外键一旦创建，就绑定到具体列名和表名。如果后续数据库改了字段名（比如 user_id 改成 creator_id），图表连线不会自动更新，也不会报错——它只是静默失效。