CMAKE_INSTALL_PREFIX

由 install() 使用的安装目录。

如果调用 make install 或构建 INSTALL 目标，此目录将添加到所有安装目录的前面。

此变量默认值如下：

  • 3.29 版本新增: 如果设置了 CMAKE_INSTALL_PREFIX 环境变量，则其值将用作此变量的默认值。

  • Windows 上为 c:/Program Files/${PROJECT_NAME}。

  • UNIX 平台上为 /usr/local。

请参阅 CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT，了解项目如何选择自己的默认值。

在 UNIX 上，可以使用 DESTDIR 机制将整个安装重新定位到暂存区。有关更多信息，请参阅 DESTDIR 环境变量。

安装前缀也会添加到 CMAKE_SYSTEM_PREFIX_PATH 中，以便 find_package()、 find_program()、 find_library()、 find_path() 和 find_file() 将在此前缀中搜索其他软件。可以通过在首次调用 project() 之前将 CMAKE_FIND_NO_INSTALL_PREFIX 设置为 TRUE 来禁用此行为。

注意

使用 GNUInstallDirs 模块为安装目录内的布局提供 GNU 风格的选项。

可以在配置构建树时定义 CMAKE_INSTALL_PREFIX 以设置其安装前缀。或者，当使用 cmake(1) 命令行工具的 --install 模式时，可以使用 --prefix 选项指定不同的前缀。

cmake --install . --prefix /my/install/prefix