CMake如何创建自定义目标，无需重设安装前缀切换安装/部署路径

原代码问题 #

你写的DEPLOY目标参数混用了CMake的两种运行模式：--install是CMake独立的安装命令参数，不能跟在--build参数后作为构建阶段的参数，因此原实现无法正常运行。

正确实现逻辑 #

你不需要修改现有默认install目标的逻辑，预设的CMAKE_INSTALL_PREFIX已经可以满足本地安装无需重新配置的需求，只需要调整DEPLOY目标的写法即可：

基础实现（固定服务器部署路径） #

# 定义服务器固定部署路径，可根据实际需求修改
set(DEPLOY_PREFIX "/your/server/fixed/deploy/path" CACHE PATH "Deployment target root path")

add_custom_target(DEPLOY
    # 直接调用cmake --install命令，通过--prefix参数临时覆盖安装前缀
    COMMAND ${CMAKE_COMMAND} --install . --prefix ${DEPLOY_PREFIX}
    WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
    COMMENT "Deploying build artifacts to ${DEPLOY_PREFIX}"
)
# 配置DEPLOY目标不会被默认构建，避免和常规构建逻辑冲突
set_target_properties(DEPLOY PROPERTIES EXCLUDE_FROM_ALL TRUE)

扩展实现（需要额外部署操作） #

如果部署阶段需要执行改权限、上传远程服务器等额外操作，可以直接在自定义目标中追加命令：

add_custom_target(DEPLOY
    COMMAND ${CMAKE_COMMAND} --install . --prefix ${DEPLOY_PREFIX}
    # 示例：修改部署后二进制文件权限
    COMMAND chmod 750 ${DEPLOY_PREFIX}/bin/*
    # 示例：直接上传到远程服务器（可根据实际场景调整）
    # COMMAND scp -r ${DEPLOY_PREFIX}/* ops@your-prod-server:/opt/proj/
    WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
    COMMENT "Running deployment process"
)

使用方式 #

• 本地安装：直接执行cmake --build <构建目录> --target install，构建产物会自动安装到你预设的../../_install路径，无需重新配置CMake
• 服务器部署：直接执行cmake --build <构建目录> --target DEPLOY，构建产物会自动安装到预设的服务器固定路径
• 临时修改路径：如果需要临时变更安装/部署路径，无需重新执行cmake配置，直接在安装阶段指定前缀即可，例如：
  • 临时本地安装到/tmp/test：cmake --install <构建目录> --prefix /tmp/test
  • 临时部署到测试服务器路径：cmake --build <构建目录> --target DEPLOY -- -D DEPLOY_PREFIX=/tmp/test_deploy

核心原理 #

cmake --install的--prefix参数是安装阶段的临时覆盖参数，不会修改CMake缓存中的CMAKE_INSTALL_PREFIX配置，因此完全不需要每次调整路径就重新生成构建系统，符合你减少命令行输入、无需重复配置的需求。

内容的提问来源于stack exchange，提问作者def