Linux下C++项目链接失败：glad函数未定义（Windows编译正常）

数据老陈

2026-7-15

问题原因分析

Linux与Windows的共享库符号导出机制存在本质差异：

Windows下编译共享库时，默认会导出大部分符号（或通过__declspec(dllexport)显式标记），因此SandBox能顺利找到Physx2D中编译的glad符号。
Linux下共享库默认隐藏非显式导出的符号（默认可见性为hidden），即便glad.c被编译进Physx2D共享库，glad_*系列函数符号也不会对外暴露，导致SandBox链接时无法定位这些符号。

此外，Premake脚本中若未正确处理Linux平台下共享库的编译参数或链接顺序，也可能加剧该问题。

解决方法

针对上述问题，可按以下方案处理：

1. 显式导出Physx2D中的glad符号

在glad的头文件（通常为glad.h）中添加平台相关的导出宏，确保Linux下glad函数符号被导出：

#ifdef __linux__
#define GLAD_API __attribute__((visibility("default")))
#elif _WIN32
#define GLAD_API __declspec(dllexport)
#else
#define GLAD_API
#endif

// 在所有glad函数声明前添加该宏
GLAD_API void glad_glClear(GLbitfield mask);
// 其余glad函数声明同理

若嫌逐个标记麻烦，也可在编译Physx2D时添加-fvisibility=default参数强制导出所有符号（此方法简单但可能导出冗余符号，不推荐生产环境使用），在Premake脚本中配置如下：

filter "system:linux"
    buildoptions { "-fvisibility=default" }

2. 修正Premake脚本的链接配置

确保SandBox项目正确链接Physx2D共享库，且Linux下链接顺序符合规则（依赖库需放在被依赖项目之后）。检查SandBox的链接配置：

project "SandBox"
    kind "ConsoleApp"
    -- 其他项目配置...
    links {
        "Physx2D",
        "glfw3" -- 若Physx2D依赖glfw，需确保此处正确链接（或让Physx2D自动传递依赖）
    }