add_library中必须显式使用shared关键字，否则默认生成静态库；动态库需用target_include_directories导出头文件路径，并在windows下用target_compile_definitions导出符号；依赖库须用target_link_libraries挂载到目标上，不可遗漏或误用全局命令。
add_library 里必须用 SHARED 关键字
不写 SHARED，CMake 默认生成静态库（STATIC），哪怕你文件名带 .so 或 .dll，它也只按静态规则链接和安装。正确写法是：
add_library(mylib SHARED src/a.cpp src/b.cpp)
注意：SHARED 和源文件列表之间不能加 INTERFACE、OBJECT 等其他关键字；如果误写成 add_library(mylib SHARED INTERFACE ...)，CMake 会报错 Cannot specify both SHARED and INTERFACE。
头文件导出要靠 target_include_directories + target_compile_definitions
动态库本身不自动暴露头文件路径，调用方编译时找不到声明，会报 undefined reference 或 no declaration of ...。必须显式导出：
-
target_include_directories(mylib PUBLIC $<build_interface:>)</build_interface:>—— 让依赖它的目标能加进自己的-I - Windows 下还需导出符号：加
target_compile_definitions(mylib PUBLIC MYLIB_EXPORTS)，并在头文件里用#ifdef MYLIB_EXPORTS控制__declspec(dllexport) - Linux/macOS 一般不用额外定义，但若用了
visibility=hidden编译选项，则需在函数/类前加__attribute__((visibility("default")))
链接依赖项必须用 target_link_libraries(SHARED)
如果你的动态库依赖其他库（比如 fmt 或另一个 SHARED 库），不能只写 find_package(fmt) 就完事。必须把依赖链挂到目标上：
find_package(fmt REQUIRED) add_library(mylib SHARED src/lib.cpp) target_link_libraries(mylib PRIVATE fmt::fmt)
这里 PRIVATE 表示仅 mylib 内部使用 fmt，不向使用者透出；如果 fmt 的头文件被 mylib 的 public 头里直接 #include 了，就得改成 PUBLIC，否则下游编译失败。
常见错误：漏掉 target_link_libraries，或写成 link_libraries(fmt::fmt)（全局作用，已废弃且不生效）。
Windows 上 DLL 导出符号容易漏掉 .def 文件或 __declspec
MSVC 默认不导出任何符号，即使你写了 SHARED，生成的 .dll 也可能空壳——调用方 LoadLibrary 成功，但 GetProcAddress 找不到函数。解决方式二选一：
- 用
__declspec(dllexport)：在头文件中定义宏，如#define MYLIB_API __declspec(dllexport)，然后声明函数为MYLIB_API int foo(); - 用 .def 文件：在 CMake 中通过
set_target_properties(mylib PROPERTIES LINK_FLAGS "/DEF:mylib.def")指定，.def 文件里写EXPORTS\nfoo\nbar
注意：CMake 的 WINDOWS_EXPORT_ALL_SYMBOLS 属性虽方便，但会导出所有符号（含 STL 模板实例、私有函数），增大体积且破坏封装，不建议在发布版本中启用。
真正麻烦的不是怎么写 SHARED，而是跨平台符号可见性控制和头文件传播路径是否对齐——这两处出问题，编译可能成功，但链接或运行时报错，而且错误信息往往不指向根源。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
