CMake在OS X下处理含特殊字符文件名的拷贝构建问题

Hey there! 作为长期Stack Overflow读者终于迈出提问第一步，必须给你打call😎。你的问题核心是CMake生成Makefile时，没有正确转义文件名里的#符号，导致Make把它当成注释截断了依赖行，最终报出"missing separator"错误。下面给你两个靠谱的解决方案：

方案一：用自定义命令手动拷贝资源（最可靠） #

绕过CMake默认的MACOSX_PACKAGE_LOCATION自动处理逻辑，改用add_custom_command和add_custom_target手动控制资源拷贝，这样能确保特殊字符被正确转义：

# 定义源资源和目标路径
set(TESTFILE "/Users/<user>/resources/my resource folder/file_name#1.gif")
set(RESOURCE_TARGET_DIR "${CMAKE_CURRENT_BINARY_DIR}/MyApp.app/Contents/Resources/my resource folder")

# 先创建目标目录，避免拷贝时出错
file(MAKE_DIRECTORY ${RESOURCE_TARGET_DIR})

# 添加自定义拷贝命令，明确指定源和目标
add_custom_command(
    OUTPUT "${RESOURCE_TARGET_DIR}/file_name#1.gif"
    COMMAND ${CMAKE_COMMAND} -E copy "${TESTFILE}" "${RESOURCE_TARGET_DIR}/file_name#1.gif"
    MAIN_DEPENDENCY ${TESTFILE}
    COMMENT "Copying resource with special characters: ${TESTFILE}"
)

# 创建自定义目标，确保拷贝动作在构建时执行
add_custom_target(CopyAppResources ALL DEPENDS "${RESOURCE_TARGET_DIR}/file_name#1.gif")

# 主应用目标依赖资源拷贝目标，保证资源先拷贝再构建应用
add_executable(MyAppDebug MACOSX_BUNDLE ${SOURCE_LIST})
add_dependencies(MyAppDebug CopyAppResources)

# 保持你原有的目标属性设置
set_target_properties(MyAppDebug PROPERTIES
    RUNTIME_OUTPUT_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/bin/DebugOsx"
    OUTPUT_NAME "MyApp"
    MACOSX_BUNDLE TRUE
    MACOSX_BUNDLE_BUNDLE_NAME MyApp
    MACOSX_BUNDLE_BUNDLE_VERSION 1
    MACOSX_BUNDLE_SHORT_VERSION_STRING "1.0.0"
    MACOSX_BUNDLE_GUI_IDENTIFIER org.mycompany.myapp
)

这种方法完全避开了CMake自动生成依赖行时的转义漏洞，因为拷贝命令是通过CMake自身的-E copy执行的，它能正确处理带特殊字符的路径。

方案二：尝试Generator Expression转义路径 #

如果不想放弃MACOSX_PACKAGE_LOCATION的便捷性，可以试试用$<SHELL_PATH:>生成器表达式来处理资源路径，它会自动为当前shell环境转义特殊字符：

set(TESTFILE "/Users/<user>/resources/my resource folder/file_name#1.gif")
# 用SHELL_PATH转义路径后再设置属性
set_property(SOURCE $<SHELL_PATH:${TESTFILE}> PROPERTY MACOSX_PACKAGE_LOCATION "Resources/my resource folder")
add_executable(MyAppDebug MACOSX_BUNDLE ${SOURCE_LIST} $<SHELL_PATH:${TESTFILE}>)

# 保持原有的target属性设置...

不过这个方法的兼容性可能不如方案一，因为它依赖CMake对生成器表达式的处理是否覆盖了所有特殊字符场景。

问题根源解释 #

CMake在生成Makefile时，只对文件名里的空格做了转义（变成\ ），但没有处理#符号——而Make会把#当作注释的开始，导致第4112行的依赖关系被截断，剩下的内容不符合Makefile语法，所以报出"missing separator"错误。手动给#加反斜杠\#后，Make才会把它当作文件名的一部分处理。

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