如何在C++Builder中使用静态库libsodium.lib？链接错误求助

我在C++Builder中使用静态库libsodium.lib时遇到链接错误，提示unresolved external symbol '_sodium_init'，但相同逻辑的代码在Visual Studio中可以正常运行。

C++ Builder 代码 #

//...
#define SODIUM_STATIC
extern "C" {
#include <sodium.h>
}

void __fastcall TForm1::FormShow(TObject *Sender)
{
    if (sodium_init() < 0) 
        Edit1->Text = L"Failure"; 
    else 
        Edit1->Text = L"Success";
}

链接器错误：unresolved external symbol '_sodium_init'

Visual C++ 代码 #

//...
#define SODIUM_STATIC
#include <sodium.h>

int main()
{
    if (sodium_init() < 0) {
        std::cout << "Failure" << std::endl; 
        return 1;
    }
    std::cout << "Success" << std::endl;
    return 0;
}

运行正常！

解决思路 #

• 匹配库的编译环境
  Visual Studio的MSVC编译器和CBuilder的bcc32/bcc64/Clang编译器生成的静态库二进制格式不兼容。必须使用**对应CBuilder版本编译的libsodium静态库**，不能直接复用VS编译的版本。若没有现成库，需下载libsodium源码，用C++Builder自带编译器重新编译生成静态库。

• 确保宏定义全局生效
  确认SODIUM_STATIC宏在所有包含sodium.h的代码前定义，推荐直接在项目全局设置中添加：进入项目选项→编译器→条件定义，添加SODIUM_STATIC，避免仅在单个文件中定义导致的作用域问题。

• 检查链接器配置
  在C++Builder项目设置中确认已正确引入静态库：

  1. 打开项目选项→链接器→输入
  2. 在「附加依赖项」中添加libsodium.lib的完整路径，或把lib文件放到项目搜索目录中
     同时注意区分32/64位版本：32位项目必须链接32位库，64位项目对应64位库，混版会导致符号无法匹配。

• 验证符号名修饰规则
  用CBuilder自带的tdump工具查看libsodium.lib中的符号，确认sodium_init的实际符号名是否为_sodium_init。若库中符号是sodium_init（无前缀下划线），需调整编译器名字修饰选项，或重新编译库时匹配CBuilder的编译设置。

• 尝试动态库替代
  若静态库问题难以排查，可改用libsodium动态库版本（libsodium.dll），配合对应的导入库使用。此时不需要定义SODIUM_STATIC，只需确保动态库文件在程序运行路径中即可。

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