静态库必须经历「编译目标文件→打包归档→正确链接」三步，缺一不可；ar rcs libxxx.a xxx.o 中的 s 生成符号索引，确保链接器能定位函数，库名须为 libxxx.a，且需配合 -L 和 -l 正确使用。
直接说结论：静态库不是“写完就扔过去就能用”的东西，它必须经历「编译目标文件 → 打包归档 → 正确链接」三步，缺一不可；任何一步路径、符号或头文件不匹配，都会导致 undefined reference 或编译失败。
怎么用 ar 打包成 .a 文件（Linux/macOS）
这是最底层、最可控的方式，适合调试或 CI 环境中避免构建系统干扰。
常见错误现象：执行 ar rcs libmylib.a mylib.o 后，链接时报 undefined reference to 'add'，但你明明在 mylib.cpp 里实现了 add()。
- 先确认
mylib.o确实含该符号：nm -C mylib.o | grep add—— 如果没输出，说明函数没被编译进去（比如被#ifdef掉了，或声明/定义不一致） -
ar rcs中的s很关键：它生成索引表，让链接器能快速定位符号；漏掉s（如只写rc），某些旧版ld会找不到符号 - 库名必须以
lib开头、.a结尾，否则-lmylib无法自动映射到libmylib.a - 如果你的源码含 C++ 类或重载函数，且要供 C 代码调用，必须在函数声明前加
extern "C"，否则 C 链接器看不到 mangled 名字
g++ 链接时为什么总报 cannot find -lmylib
这不是库不存在，而是链接器根本没搜到它——路径和命名规则比“放对地方”更严格。
立即学习“C++免费学习笔记（深入）”；
使用场景：你在 main.cpp 里写了 g++ main.cpp -L./libs -lmylib -o main，但提示找不到库。
-
-L./libs只影响链接阶段，不影响编译阶段；头文件仍需用-I./libs/include显式指定，否则#include "mylib.h"直接报错 -
-lmylib会查找名为libmylib.a（优先）或libmylib.so（次选）的文件；如果实际文件是mylib.a或libmylib_static.a，必须写全路径：./libs/mylib.a，不能用-l参数 - 多个
-L路径有顺序：链接器从左到右搜索，遇到第一个匹配即停；若系统目录（如/usr/lib）在前，而你本地的libmylib.a在后，可能误链了系统里同名旧库
CMake 中 add_library(... STATIC) 的坑在哪
看似封装了细节，但 CMake 的属性传递机制（PUBLIC/PRIVATE/INTERFACE）一旦设错，下游项目就会头文件找不到、宏未定义、或链接失败。
参数差异：同样是链接静态库，target_link_libraries(myapp PRIVATE mylib) 和 PUBLIC 效果天差地别。
- 用
PRIVATE：只有myapp能用mylib的实现，其依赖关系不会透出；但如果myapp的头文件里#include "mylib.h"，下游项目包含myapp.h时就会报错——因为头文件路径没传递过去 - 正确做法：对静态库本身，用
target_include_directories(mylib PUBLIC $<include>)</include>；对使用者，用target_link_libraries(myapp PUBLIC mylib)，这样头文件路径和 compile definitions 才会自动继承 - 别手动写
link_directories()：它是全局作用域，易污染其他 target；应始终用target_link_libraries()+find_package()或add_subdirectory()管理依赖
Windows 下用 MSVC 编译 .lib 时要注意什么
MSVC 的 lib.exe 不是 POSIX 的 ar，行为差异会导致跨平台项目在 CI 上突然失败。
性能 / 兼容性影响：Windows 静态库默认带编译器运行时绑定（如 /MT vs /MD），混用会导致运行时崩溃。
- 编译源文件时，必须和主工程用**完全一致**的运行时选项：如果主程序用
/MD（动态链接 CRT），你的mylib.cpp也必须用/MD编译，否则链接时报一堆LNK2005（重复定义malloc等） -
lib.exe命令不支持-rcs这种语法；正确命令是：lib mylib.obj /OUT:mylib.lib；注意它不自动生成库名前缀lib，也不强制后缀，命名完全由你控制 - MSVC 下没有
-l机制；链接时直接写mylib.lib（路径+文件名），或用target_link_libraries(myapp mylib)让 CMake 自动补后缀
最容易被忽略的是：静态库里的全局变量或 static 局部变量，在多个翻译单元中是否会被重复实例化——这取决于你有没有用 inline 或 extern template 控制；一旦出现“值初始化两次”或“单例失效”，问题极难复现和定位。
