讲师中心 微信公众号
AI工具推荐 视频效率加速

CMakeLists怎么写卸载逻辑?

老芳君_2973

老芳君_2973

发布时间:2026-08-08 14:58:02

|

739人浏览过

|

来源于php中文网

原创

CMake 默认不提供 uninstall 目标,因其不记录安装路径或文件归属;需手动添加 uninstall 目标并读取 install_manifest.txt 清单执行删除,且仅适用于开发调试。

cmakelists怎么写卸载逻辑?

卸载目标为什么不能直接用 make uninstall

CMake 本身不生成 uninstall 目标,这是常见误解。你执行 make uninstall 报错 make: *** No rule to make target 'uninstall'. Stop.,不是因为你写错了,而是 CMake 默认根本不提供这个目标——它不记录安装路径、不跟踪文件归属、也不生成反向操作逻辑。

手动添加 uninstall 目标的正确写法

必须显式在 CMakeLists.txt 末尾追加一段逻辑,核心是:读取 install_manifest.txt(CMake 生成的已安装文件清单),逐行删除。

  • 确保你已启用 INSTALL 命令(否则没有清单可读)
  • 把以下代码块放在 CMakeLists.txt 最后(不能在 project() 前,也不能被条件编译包裹)
if(EXISTS "${CMAKE_BINARY_DIR}/install_manifest.txt")
  file(READ "${CMAKE_BINARY_DIR}/install_manifest.txt" files)
  string(REPLACE "\n" ";" files "${files}")
  foreach(file ${files})
    message(STATUS "Uninstalling $<TARGET_FILE:${file}>")
    if(EXISTS "${file}")
      file(REMOVE "${file}")
      message(STATUS "Deleted ${file}")
    else()
      message(WARNING "File not found: ${file}")
    endif()
  endforeach()
endif()

注意:install_manifest.txt 只在执行过 make install 后才存在,路径固定为构建目录下,不是源码目录。

cmake -P 方式比 make uninstall 更可靠

上面那段代码只是定义了逻辑,但没绑定到 uninstall 目标。真正让 make uninstall 可用,得再加一个自定义目标:

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
add_custom_target(uninstall
  COMMAND ${CMAKE_COMMAND} -P "${CMAKE_CURRENT_SOURCE_DIR}/cmake_uninstall.cmake")

然后把上面那段逻辑单独存为 cmake_uninstall.cmake(和 CMakeLists.txt 同级),内容不变。这样 make uninstall 就能调用它。

  • 别把逻辑硬塞进 CMakeLists.txt 里用 COMMAND ${CMAKE_COMMAND} -E rm 拼接,容易路径转义出错
  • ${CMAKE_COMMAND} -P 是唯一安全执行 CMake 脚本的方式,支持 file(READ) 等完整 API
  • 如果项目用了 DESTINATION 动态变量(如 ${CMAKE_INSTALL_PREFIX}),清单里存的是绝对路径,无需额外拼接

卸载失败的三个典型原因

即使脚本写对了,uninstall 仍可能静默失败或删错文件:

  • install_manifest.txt 被手动删过,或 make install 是用不同构建目录执行的——清单路径不对,脚本直接跳过
  • 安装时用了 sudo make install,但卸载时没加 sudo,权限不足导致 file(REMOVE) 静默失败(CMake 不报错)
  • 多个 target 安装到同一路径(比如两个库都装到 lib/),卸载会删掉别人的东西——CMake 不做依赖隔离

真正的生产环境卸载,从来不是靠 make uninstall,而是用包管理器(deb/rpm)或带事务回滚的安装器;CMake 的卸载逻辑只适合开发调试阶段临时清理。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

更多
C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

6886

2025.10.17

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

1631

2025.10.23

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

374

2025.12.13

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

40

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

20

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

20

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

0

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

20

2026.10.22

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

20

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
LLVM CMake构建指南
LLVM CMake构建指南

共0课时 | 0人学习

LLVM入门手册
LLVM入门手册

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn