17370845950

C++静态库是将编译后的目标文件（.obj/.o）打包成归档文件（Windows为.lib，Linux/macOS为.a），仅提供已编译符号定义；需分离头文件与实现、只编译不链接、再用ar/lib工具打包，最后在链接时指定头文件路径、库路径及库名。

在C++中创建静态库，本质是把编译后的目标文件（.obj 或 .o）打包成一个归档文件（Windows下为 .lib，Linux/macOS下为 .a），供其他程序链接时使用。它不包含运行时逻辑，只提供已编译的符号定义。

准备源代码和头文件

静态库需要清晰分离接口与实现：

• 写一个头文件（如 math_utils.h），声明函数或类接口，用 #pragma once 或卫士宏防止重复包含
• 写对应的实现文件（如 math_utils.cpp），只包含该头文件并实现声明的函数
• 确保没有 main() 函数，也不依赖未提供的第三方动态库

编译生成目标文件（.obj 或 .o）

关键：只编译，不链接。禁用运行时库自动链接（尤其Windows），避免引入不必要的依赖。

• Windows（MSVC）：cl /c /EHsc /O2 math_utils.cpp
  → 生成 math_utils.obj（/c 表示只编译）
• Linux/macOS（g++/clang++）：g++ -c -O2 math_utils.cpp
  → 生成 math_utils.o（-c 表示只编译）

打包成静态库文件

用归档工具把目标文件“压缩”成库，不进行任何代码变换。

• Windows（MSVC）：lib math_utils.obj /OUT:math_utils.lib
  → 得到 math_utils.lib
• Linux：ar rcs libmath_utils.a math_utils.o
  → 得到 libmath_utils.a（r=插入，c=静默创建，s=生成索引）
• macOS：libtool -static -o libmath_utils.a math_utils.o
  或直接用 ar（行为与Linux基本一致）

在项目中使用静态库

使用时需同时提供头文件路径、库文件路径和库名，由链接器在编译末期解析符号。

• Windows（MSVC命令行）：
  cl main.cpp /I. /link math_utils.lib
  （/I. 告诉编译器在当前目录找头文件）
• Linux（g++）：
  g++ main.cpp -I. -L. -lmath_utils -o main
  （-L. 指定库路径，-lmath_utils 自动匹配 libmath_utils.a）
• 注意：静态库中的符号必须被主程序实际调用，否则链接器可能丢弃（启用 /OPT:NOREF 或 --no-as-needed 可强制保留）

基本上就这些。核心就是“先编译出 .o/.obj，再用 ar/lib 打包”，不复杂但容易忽略 -c 和路径配置细节。