C++跨平台库Link Seam的UML关系表示方法咨询

你描述的是典型的C++跨平台Link Seam模式：共享头文件定义类接口，不同平台用专属cpp实现类方法，编译时只选对应平台的模块。先回顾下你的示例代码：

// CommonHeader.h
#ifndef COMMON_HEADER_H
#define COMMON_HEADER_H
class MyClass {
public:
    void foo();
};
#endif

// WindowsModule.cpp
#include "CommonHeader.h"
void MyClass::foo() {
    // Windows API逻辑
    printf("This implements the Windows version\n");
}

// LinuxModule.cpp
#include "CommonHeader.h"
void MyClass::foo() {
    // Linux专属逻辑
    printf("This implements the Linux version\n");
}

首先得明确：这种模式是编译时的实现选择，和运行时多态、类依赖完全不是一回事，所以UML里用继承、依赖都不合适。下面是几种规范的表示方式：

1. UML工件（Artifact）+ 构造型（最推荐） #

这是最贴合你场景的表达，因为不同平台的cpp本质是编译工件：

• 先画出MyClass类，对应CommonHeader.h里的接口定义，展示它的公共方法foo()
• 创建两个Artifact（UML中用于表示代码文件、二进制包等实体），分别命名为WindowsModule.cpp和LinuxModule.cpp
• 给每个Artifact添加自定义构造型，比如<<Windows-specific implementation>>或<<platform implementation>>，明确标注其平台属性
• 用**实现关系（带空心三角的虚线箭头）**从每个Artifact指向MyClass类，清晰传达「该工件实现了类的方法」的含义
• 可以额外添加一个注释框，说明「构建时仅选择对应运行环境的Artifact编译，避免符号冲突」

2. 类+平台实现标记（简化版） #

如果不想引入Artifact元素，也可以用简化方式：

• 画出MyClass类，然后在类的旁边添加两个带构造型的节点，分别标记<<Windows>>和<<Linux>>，对应两个cpp的实现
• 用虚线将这些节点与MyClass连接，并添加注释说明这是编译时选择的不同实现版本

绝对要避开的错误方式 #

• 继承：别用继承！这里没有父子类关系，你不是在定义基类然后派生子类，只是同一个类的不同编译实现。用继承会严重误导阅读者，以为这是运行时多态的设计。
• 依赖：依赖关系表示一个类使用另一个类的功能，而你这里是同一个类的不同实现，不存在“谁依赖谁”的情况，所以依赖关系完全不适用。

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