如何让MSVC链接DLL时排除特定函数以兼容旧版Autodesk Maya？

问题描述 #

我正在开发适用于Autodesk Maya 2020的插件DLL，需链接Maya的OpenMayaUI动态库。按惯例同主版本的Maya插件应兼容所有子版本，但Autodesk在Maya 2020.3的OpenMayaUI.dll中新增了一个函数，导致用2020.3/2020.4版库编译的插件无法在2020.0-2020.2中加载，提示“找不到指定程序”。

我的构建脚本需在任意Maya 2020版本环境运行，但生成的插件必须兼容Maya 2020.0。已知该问题函数的修饰/未修饰名称及序号，且它是一个虚拟成员函数（未调用也会被链接）。请问能否使用Visual Studio 2019的MSVC命令行编译器，在链接2020.4版OpenMayaUI.lib时，排除该特定函数？

解决方案 #

可以实现，你可以通过MSVC链接器的/EXCLUDE选项结合手动补充虚函数实现的方式解决这个问题，具体操作如下：

1. 使用链接器/EXCLUDE选项排除指定符号 #

MSVC链接器支持通过/EXCLUDE:symbol参数从链接过程中排除特定符号。由于目标是虚拟成员函数，必须使用它的**修饰名称（mangled name）**来指定（未修饰名称无法被链接器识别）。

在命令行编译时，将该参数添加到链接器选项中，示例命令如下：

link /DLL /OUT:YourMayaPlugin.dll YourObjectFiles.obj OpenMayaUI.lib /EXCLUDE:?YourProblemFunction@YourClassName@@UEAAXXZ

你可以通过dumpbin /symbols OpenMayaUI.lib命令导出库中的符号列表，确认目标函数的准确修饰名，确保参数中的符号完全匹配。

2. 手动补充虚函数的空实现 #

由于该函数是虚拟成员函数，编译器会将其加入类的虚函数表（vtable）中。仅排除符号可能导致虚表结构不完整，触发运行时未定义行为。因此需要在插件代码中手动提供该虚函数的空实现，让编译器用自定义实现替代高版本库中的符号，保证虚表结构与Maya 2020.0版本一致：

class YourMayaDerivedClass : public MayaBaseClass {
public:
    // 手动实现新增的虚函数，保持空逻辑
    virtual void YourProblemFunction() override {}
};

3. 验证插件兼容性 #

链接完成后，使用dumpbin /imports YourMayaPlugin.dll命令检查插件的导入表，确认目标函数没有被包含在其中，以此确保插件能在Maya 2020.0-2020.2版本中正常加载。

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