CMake基础: 全局变量CMAKE_POSITION_INDEPENDENT_CODE

目录

1.简介

2.CMake 配置方式

3.注意事项

4.与 BUILD_SHARED_LIBS 的关系

1.简介

这是 CMake全局变量，用来统一控制是否默认生成位置无关代码（-fPIC）。这是构建共享库 (Shared Libraries, .so/.dll)的必要条件。

核心作用：

• 生成位置无关代码：代码中不使用绝对地址，而是通过相对寻址或全局偏移表 (GOT) 来访问数据和函数。
• 支持动态加载：只有启用 PIC 的代码才能被动态链接器加载到内存的任意位置，这是实现共享库和可执行文件灵活加载的基础。

2.CMake 配置方式

1.全局配置 (推荐)

为项目中所有目标设置 PIC 属性：

set(CMAKE_POSITION_INDEPENDENT_CODE ON)

2.单个目标配置

为特定库 / 可执行文件单独设置：

add_library(my_shared_lib SHARED src/library.cpp) # 显式为该目标开启 PIC set_target_properties(my_shared_lib PROPERTIES POSITION_INDEPENDENT_CODE ON )

3.条件编译

根据平台或构建类型条件开启：

if (UNIX AND BUILD_SHARED_LIBS) set(CMAKE_POSITION_INDEPENDENT_CODE ON) endif()

3.注意事项

• 共享库默认开启：当使用add_library(... SHARED)时，CMake 会自动为你设置POSITION_INDEPENDENT_CODE为ON，通常无需手动干预。
• 静态库与 PIC：虽然静态库 (.a/.lib) 通常不需要 PIC，但如果它未来会被链接到共享库中，建议也为其开启 PIC，以避免潜在的链接错误。
• 平台差异：
  • Linux/macOS：构建共享库强烈要求 PIC，否则会报错。
  • Windows：DLL 本身不依赖-fPIC编译选项（其机制不同），但 CMake 仍支持该属性以保持跨平台兼容性。

4.与BUILD_SHARED_LIBS的关系

当你设置set(BUILD_SHARED_LIBS ON)时，所有通过add_library创建的库默认都会构建为共享库，并自动启用 PIC 特性。