修改可能为空的CMake列表的正确方法（以CMAKE_MODULE_PATH为例）

这绝对是CMake里反复被问到的经典问题了，尤其是当路径里藏着分号这种特殊字符时，不同写法的坑会立刻暴露出来。结合你提到的几种方案，咱们来拆解最稳妥的实现方式，同时覆盖CMAKE_MODULE_PATH未设置、为空、已设置的所有场景：

先明确核心前提 #

CMAKE_MODULE_PATH本质是一个CMake列表变量，元素之间用分号;分隔。操作列表变量，CMake有专门的命令，这比用普通的set要靠谱得多。

逐个分析你的方案 #

方案1：直接用set不带引号 #

set (CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmakeModules ${CMAKE_MODULE_PATH})

这个写法的隐患在于：如果你的路径（比如CMAKE_CURRENT_SOURCE_DIR）里包含分号（虽然少见但合法，比如路径叫/proj/my;module），CMake会把分号当成列表分隔符，直接把这个路径拆成两个无效的元素/proj/my和module，导致后续找不到模块。

方案2：set搭配引号包裹新路径 #

set (CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmakeModules" ${CMAKE_MODULE_PATH})

这个写法比方案1安全，引号能确保新路径被当成一个完整的列表元素，不会被分号拆分。但本质还是用set来覆盖并重建列表，不如专门的列表命令直观，而且如果原变量未设置，虽然结果没问题，但语法上不够贴合CMake的列表操作规范。

推荐的正确写法：用列表命令操作 #

这是CMake官方最推荐的方式，分两种场景：

场景1：让自己的模块优先被查找（最常用） #

如果你希望自定义的cmakeModules目录里的模块，优先于系统或第三方模块被找到（避免同名模块冲突），用list(PREPEND)把路径放到列表最前面：

list(PREPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmakeModules")

场景2：把自己的模块放到查找链末尾 #

如果只是补充模块路径，不改变原有查找优先级，用list(APPEND)追加到列表末尾：

list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmakeModules")

为什么这两种写法最靠谱？ #

• 场景全覆盖：不管CMAKE_MODULE_PATH是未设置、为空还是已经有多个路径，列表命令都能正确处理，不会出现空变量导致的异常。
• 避免分号坑：引号包裹路径，确保任何包含分号的特殊路径都会被当成一个完整的列表元素，不会被错误拆分。
• 语法清晰：一看就知道是在给模块路径列表添加元素，可读性远高于set的写法，其他维护代码的人一眼就能明白你的意图。

额外注意点 #

如果担心重复添加同一个路径（比如多次调用这个代码片段），可以在操作后加上去重命令：

list(REMOVE_DUPLICATES CMAKE_MODULE_PATH)

不过一般情况下不需要，除非你的项目结构有特殊的重复触发场景。

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