如何避免多文件PlantUML ER图中出现重复关系？

针对你遇到的「实体文件中定义关系导致重复加载」的问题，这里有几个实用的解决思路：

1. 用条件宏控制关系加载 #

给实体文件中的关系定义加上条件判断，只有在特定宏被定义时才加载关系，避免重复渲染。

示例： #

• entity.users.swd 内容：

entity users {
  id: UUID
  username: VARCHAR(50)
  email: VARCHAR(100)
}

# 只有定义了INCLUDE_USERS_RELATIONS时才加载关系
!ifdef INCLUDE_USERS_RELATIONS
users ||--o{ user_role
!endif

• 系统表视图文件（system_view.puml） 内容：

# 先定义宏，确保users的关系会被加载
!define INCLUDE_USERS_RELATIONS
!include entity.users.swd
!include entity.user_role.swd

注意：同一个关系只在一个实体文件中用条件宏定义，不要在两个关联实体中都加，否则还是会重复。

2. 关系单独抽离为独立文件 #

把表间关系从实体文件中剥离，单独放在专门的关系文件里，由视图文件按需引入，从根源避免重复。

示例： #

• 新建 relations/user_user_role.puml 文件：

users ||--o{ user_role

• 全量视图文件（full_view.puml） 内容：

!include entity.users.swd
!include entity.user_role.swd
!include relations/user_user_role.puml

这种方式的优势是关系逻辑集中管理，视图可以灵活组合实体和对应的关系，完全避免重复加载的问题。

3. 使用PlantUML的!once指令 #

利用PlantUML的!once指令替代!include，确保关系文件即使被多次引用，也只会被加载一次。

示例： #

• entity.users.swd 内容：

entity users {
  id: UUID
  username: VARCHAR(50)
  email: VARCHAR(100)
}

# 用!once引用关系文件，确保只加载一次
!once relations/user_user_role.puml

• relations/user_user_role.puml 内容：

users ||--o{ user_role

这样不管users实体被多少个视图或其他实体文件引用，关系只会被渲染一次，不会重复。

内容的提问来源于stack exchange，提问作者RicardoPHP