一个 CMake 项目是否只能有一个 install 目录？

很多开发者误以为：在同一个 CMakeLists.txt 中只能指定一个安装目录。但实际上------

CMake 只有一个安装根目录（Install Prefix），但可以有多个安装目标路径（Destination）。

也就是说，你可以写很多 install() 指令，并把不同文件安装到不同子目录，但这些路径最终都会附着在同一个 CMAKE_INSTALL_PREFIX 下。

例如：

cpp 复制代码

install(TARGETS MyApp RUNTIME DESTINATION bin)
install(FILES libMyLib.so DESTINATION lib)
install(DIRECTORY include/MyAPI DESTINATION include)
install(FILES config.ini DESTINATION etc)

执行：

cpp 复制代码

cmake -DCMAKE_INSTALL_PREFIX=./deploy ..
make install

会生成：

deploy/

├── bin/MyApp

├── lib/libMyLib.so

├── include/MyAPI/

└── etc/config.ini

所以：

❌ 并非只能有一个安装目录
✔ 但所有安装路径必须在 prefix 这一前缀下展开

📌为什么 prefix 必须唯一？

因为 install() 的设计目标不是简单复制，而是：

|--------------------------|--------------|
| 功能 | install 是否支持 |
| 统一可部署路径 | ✔ |
| 支持 CPack 打包 RPM/DEB/NSIS | ✔ |
| RPATH 修正与依赖追踪 | ✔ |
| 多平台路径习惯统一 | ✔ |
| 分散多个安装根目录 | ❌（违背软件部署模型） |

如果允许多个 prefix，将会导致：

安装结构不可控
打包系统无法识别
RPATH 修复失效
开发和部署不可重复

因此，prefix 必须是全局统一的"安装根"。

🧰什么时候不该用 install()？

如果只是：

编译后开发环境需要动态库
IDE运行需要资源文件同步
临时调试构建产物

那么 install() 并不适合，这些情况更适合：

add_custom_command(TARGET MyApp POST_BUILD

COMMAND ${CMAKE_COMMAND} -E copy

"$<TARGET_FILE:MyLib>"

"${CMAKE_BINARY_DIR}/runtime/"

)

这属于构建阶段行为，而非部署行为。

🚀最佳建议

|--------------|-------------------------------------------|
| 场景 | 技术方式 |
| 开发阶段需要运行依赖 | add_custom_command() / file(COPY ...) |
| 最终软件交付、打包、部署 | install() + CMAKE_INSTALL_PREFIX |

构建是构建，安装是安装，职责分清，工程结构才能健康。

🔚结语

理解 CMAKE_INSTALL_PREFIX 和 DESTINATION 的关系，是写好 CMake 部署规则的关键。只要记住这一点：

install() 不是复制文件，而是在为未来的软件分发做标准化布局。

当你的项目变大、需要支持插件、打包、多平台分发时，这种结构化思想会让你的构建系统保持可维护、可移植、可扩展。