linux c++配置如何静态编译

在 Linux 下使用 C++ 进行静态编译，通常是指把程序依赖的 C/C++ 标准库（libc、libstdc++） 以及你用到的第三方库，全部打包进最终的可执行文件里，生成 不依赖系统动态库 的二进制文件。

下面按常见场景说明。

一、最基础的静态编译（只静态链接你的代码）

g++ main.cpp -o app

这是动态链接（默认），生成的可执行文件依赖：

ldd app

二、静态链接标准库（最常见需求）

1️⃣ 使用 -static 完全静态编译

g++ main.cpp -static -o app

✅ 效果：

• 静态链接 libc、libstdc++
• 生成单个可执行文件
• 不依赖系统 glibc

❌ 注意：

• 需要系统安装 静态库

  sudo apt install libc6-dev glibc-static g++-multilib
  

• 某些库（如 pthread、dl）仍需显式指定

2️⃣ 只静态链接 libstdc++（推荐）

很多时候你只想静态 C++ 运行时：

g++ main.cpp -static-libgcc -static-libstdc++ -o app

好处：

• 不依赖 libstdc++.so
• 仍然动态链接 libc（兼容性更好）

三、静态链接第三方库

假设你有：

• libfoo.a（静态库）

g++ main.cpp -L. -lfoo -static-libgcc -static-libstdc++ -o app

⚠️ 注意顺序（很重要）：

源文件 → 库

错误示例（可能链接失败）：

g++ -lfoo main.cpp

四、CMake 中配置静态编译

方式一：完全静态

set(CMAKE_EXE_LINKER_FLAGS "-static")

或：

target_link_options(app PRIVATE -static)

方式二：只静态 C++ 运行时（推荐）

set(CMAKE_EXE_LINKER_FLAGS "-static-libgcc -static-libstdc++")

五、检查是否静态成功

ldd app

结果：

• not a dynamic executable ✅ 完全静态
• 还有 .so ❌ 仍有动态依赖

六、常见问题

❓ 报找不到 -lstdc++ 静态库

sudo apt install libstdc++-static

❓ pthread 相关错误

g++ main.cpp -static -pthread

❓ 使用 OpenSSL / Boost 等

• 必须提供 .a 版本
• 动态库（.so）无法静态链接

七、总结建议

如果你有 具体库（Boost / OpenCV / protobuf / 交叉编译） 或 发行版（Ubuntu/CentOS），我可以给你更精确的命令。