c++oding="utf-8" ?>
必须用extern "c"禁用名称修饰并配合平台特定导出标记：windows用__declspec(dllexport)，linux/macos用__attribute__((visibility("default")))且编译时加-fvisibility=hidden，确保add和log_message符号名跨平台一致为未修饰的c风格名称。
在Windows上用__declspec(dllexport)导出的函数，在Linux/macOS下链接时直接报undefined reference，因为GCC/Clang根本不识别这个修饰符，且C++编译器对函数名做名称修饰（name mangling）后，符号名在不同平台完全不一致。
统一使用extern "C"禁用C++名称修饰
第一步：在头文件中用条件编译包裹导出声明，确保C链接规范跨平台生效。
方法一：用宏封装extern "C"块和平台导出标记
#ifdef __cplusplus
#define CPP_EXTERN extern "C"
#else
#define CPP_EXTERN
#endif
#if defined(_WIN32) || defined(__CYGWIN__)
#ifdef BUILDING_MYLIB
#define MYLIB_API __declspec(dllexport)
#else
#define MYLIB_API __declspec(dllimport)
#endif
#else
#define MYLIB_API __attribute__((visibility("default")))
#endif
方法二：直接在函数声明前写死extern "C"，适用于小型库且不需动态导入/导出切换
extern "C" {
MYLIB_API int add(int a, int b);
MYLIB_API void log_message(const char* msg);
}
注意：如果头文件被C代码包含，【必须把extern "C"块整个用#ifdef __cplusplus包围，否则C编译器会报错】。
Windows与Linux/macOS导出机制对齐
Windows依赖__declspec(dllexport)，Linux/macOS依赖__attribute__((visibility("default")))配合-fvisibility=hidden编译选项，二者语义等价但语法不可互换。
① 编译动态库时，Linux/macOS必须加-fvisibility=hidden，否则所有符号默认导出，失去控制力
g++ -fPIC -fvisibility=hidden -shared -o libmylib.so mylib.cpp
② Windows下MSVC默认不隐藏符号，但为统一行为，建议显式加__declspec(dllexport)而非依赖.def文件——.def文件无法跨平台维护
③ macOS需额外添加-undefined dynamic_lookup或-Wl,-exported_symbols_list配合导出列表文件，但优先推荐用visibility属性，避免维护多套符号列表
这一步漏掉-fvisibility=hidden，会导致Linux下libmylib.so导出上千个内部符号，体积膨胀且可能引发地址冲突。
验证导出符号是否符合预期
Windows下用dumpbin /exports libmylib.dll查看实际导出表
Linux下用nm -D libmylib.so | c++filt过滤C++符号并还原可读名
macOS下用nm -DY libmylib.dylib | c++filt确认符号存在且未被mangling干扰
关键检查点：add和log_message两个函数在三平台导出符号名必须完全一致为add、log_message，不能出现_Z3addii或__Z12log_messagePKc这类修饰名——若出现，说明extern "C"未生效或头文件未被正确包含。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
