C++怎么创建和使用静态库(.a/.lib)_C++静态库编译与链接实操方法-C++-PHP中文网

C++怎么创建和使用静态库(.a/.lib)_C++静态库编译与链接实操方法

冰火之心

发布： 2025-11-05 20:55:02

原创

659人浏览过

静态库在编译时被整合进可执行文件，运行时不依赖外部文件。Linux下使用ar命令将目标文件打包为.a文件，Windows下用lib工具生成.lib文件；通过g++或cl命令链接静态库到主程序，CMake可简化跨平台构建流程，实现代码复用与模块化开发。

c++怎么创建和使用静态库(.a/.lib)_c++静态库编译与链接实操方法

在C++项目开发中，静态库是一种将多个目标文件打包成一个归档文件的方式，供其他程序链接使用。静态库在编译时被完整复制到可执行文件中，因此运行时不依赖外部库文件。Linux下通常为 .a 文件（archive），Windows下为 .lib 文件（静态库）。下面介绍如何创建和使用静态库。

1. 编写库源码

假设我们要创建一个简单的数学函数库：

math_utils.h

#ifndef MATH_UTILS_H
#define MATH_UTILS_H
<p>int add(int a, int b);
int multiply(int a, int b);</p><h1>endif

登录后复制

math_utils.cpp

立即学习“C++免费学习笔记（深入）”；

#include "math_utils.h"
<p>int add(int a, int b) {
return a + b;
}</p><p>int multiply(int a, int b) {
return a * b;
}

登录后复制

2. 编译为目标文件

先将源文件编译为对象文件（.o 或 .obj），不进行链接。

Linux/macOS:

g++ -c math_utils.cpp -o math_utils.o

登录后复制

Windows (使用 MSVC):

cl /c math_utils.cpp

登录后复制

生成 math_utils.obj

3. 创建静态库

使用归档工具将目标文件打包成静态库。

Linux/macOS:

ar rcs libmathutils.a math_utils.o

登录后复制

rcs: r 表示替换，c 创建新库，s 生成索引
生成 libmathutils.a

Windows (MSVC):

lib /OUT:mathutils.lib math_utils.obj

登录后复制

生成 mathutils.lib

4. 使用静态库

编写主程序调用库中的函数。

库宝AI

库宝AI是一款功能多样的智能伙伴助手，涵盖AI写作辅助、智能设计、图像生成、智能对话等多个方面。

109

查看详情

main.cpp

#include "math_utils.h"
#include <iostream>
<p>int main() {
std::cout << "3 + 5 = " << add(3, 5) << "\n";
std::cout << "3 * 5 = " << multiply(3, 5) << "\n";
return 0;
}

登录后复制

链接静态库编译可执行文件

Linux/macOS:

g++ main.cpp -L. -lmathutils -o main

登录后复制

-L.: 指定库搜索路径为当前目录
-lmathutils: 链接 libmathutils.a（去掉前缀和后缀）

或直接指定库文件：

g++ main.cpp math_utils.o -o main

登录后复制

Windows (MSVC):

cl main.cpp mathutils.lib

登录后复制

或

cl main.cpp /link mathutils.lib

登录后复制

5. 注意事项与技巧

确保头文件路径正确：使用 -I 指定头文件目录（如 -I./include）
静态库不会在运行时加载，所有代码会合并进可执行文件
若修改了库源码，需重新编译并更新库文件
可以用 nm libmathutils.a 查看库中包含的符号
跨平台项目建议统一命名规则和构建脚本（如 CMake）

6. 使用 CMake 管理静态库（推荐）

CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(MathLib)
<h1>创建静态库</h1><p>add_library(mathutils STATIC math_utils.cpp)</p><h1>主程序</h1><p>add_executable(main main.cpp)</p><h1>链接库</h1><p>target_link_libraries(main mathutils)
target_include_directories(mathutils PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

登录后复制

构建流程：