使用MinGW向DLL正确导出符号：私有函数为何仍可见？

我需要给Windows动态库导出特定符号，同时隐藏其余符号。以下是我在Mac M2、通过brew安装的mingw-64环境下的测试案例：

测试代码（test.c） #

#include <stdio.h>

#define DLL_EXPORT __declspec(dllexport)

DLL_EXPORT void exported_function(void) {
    printf("This is an exported function\n");
}

void private_function(void) {
    printf("This is a private function\n");
}

编译命令及结果 #

# 安装mingw-w64
$ brew install mingw-w64

# 编译生成动态库
$ x86_64-w64-mingw32-gcc -c test.c -fvisibility=hidden -shared -O3 -s -o test.dll

# 查看符号表
$ nm test.dll
         U __imp___acrt_iob_func
         U __mingw_vfprintf
00000050 T exported_function
00000060 T private_function

疑问：为什么private_function仍然在符号表中可见？我哪里遗漏了？

后续尝试 #

• 编辑1：尝试添加链接器参数-Wl,--exclude-all-symbols，无效
• 编辑2：使用-Wl,--exclude-all-symbols -Wl,--retain-symbols-file=test.sym有效（test.sym内容仅为exported_function），但仍疑惑为何__declspec(dllexport)结合-fvisibility=hidden不生效
• 编辑3：以下编译方式也能隐藏private_function：

$ x86_64-w64-mingw32-gcc -shared -O3 -s test.c -o test.dll
$ strings test.dll | grep private_function || echo "Private function not visible"

问题解答 #

为什么-fvisibility=hidden + __declspec(dllexport)没生效？ #

MinGW-w64的GCC对Windows平台的符号可见性处理有特殊性：

1. -fvisibility=hidden是GNU/Linux平台的符号可见性控制选项，在Windows平台下默认不生效，因为Windows DLL的符号导出逻辑依赖__declspec(dllexport)或.def文件，而非GNU的可见性属性。
2. 你用了-c参数只做编译不生成可执行文件，后续没有把可见性参数正确传递到链接阶段——-shared是链接阶段的参数，不该和-c一起使用。

正确的解决方法 #

方法1：使用.def文件控制导出符号

创建test.def文件：

LIBRARY test.dll
EXPORTS
    exported_function

编译命令：

x86_64-w64-mingw32-gcc test.c -shared -O3 -s -o test.dll test.def

这是Windows平台原生的符号导出控制方式，MinGW-w64完全兼容，能精准控制只导出指定符号。

方法2：修正编译命令，结合-fvisibility=hidden

需要确保-fvisibility=hidden在编译和链接阶段都生效，正确的命令应该是：

x86_64-w64-mingw32-gcc -fvisibility=hidden test.c -shared -O3 -s -o test.dll

去掉-c让GCC完成编译+链接的完整流程，此时__declspec(dllexport)会标记要导出的符号，-fvisibility=hidden会隐藏其他未标记的符号。

方法3：符号保留文件方式

使用--exclude-all-symbols配合--retain-symbols-file是链接器层面的强制控制，不管编译阶段的标记，直接只保留指定符号，适合批量控制符号导出的场景。

关于编辑3的有效方式 #

当你不添加任何可见性参数时，MinGW-w64默认只会导出带有__declspec(dllexport)标记的符号。之前用nm看到的符号是未经过完整链接优化的中间符号，而最终DLL的导出表中其实只有exported_function。可以用x86_64-w64-mingw32-dumpbin /exports test.dll查看真正的导出符号表，比nm更准确（nm是GNU工具，对Windows DLL的符号解析有偏差）。

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