问题背景 #

我正在使用msp430-gcc-9.3.1.11_linux64工具链，通过CMake构建一个简单的MSP430项目（main.c + CMake脚本）。CMakeLists.txt的核心逻辑是从已验证的项目中复制过来的，同时我参考网上资料写了一个工具链文件，但对工具链文件的理解很有限。

两个具体问题 #

问题1：无法在CMakeLists.txt中添加链接器Flags

我尝试在CMakeLists.txt中用target_link_options添加链接器参数：

### Use target_link_options to add the linker flag for the map file
target_link_options(${ApplName} PRIVATE
  -Wl,--cref,--map=${MAP_FILE_OUTPUT}
  -Wl,--no-gc-sections
)

但这些参数完全不生效。咨询AI后得知是因为工具链文件中设置了set(CMAKE_C_LINK_EXECUTABLE)，尝试改用CMAKE_EXE_LINKER_FLAGS_INIT也没解决。

提问：我需要修改什么才能在CMakeLists.txt中正常添加更多链接器Flags？

问题2：链接成功但未生成Map文件

作为临时解决方法，我把生成Map文件的Flags硬编码到了工具链文件中：

set(CMAKE_C_LINK_EXECUTABLE "${CMAKE_C_COMPILER} ${CMAKE_C_FLAGS} -o <TARGET> <OBJECTS> \
  -T${MSP430_TARGET_LINKER_SCRIPT_DIR}/msp430g2553.ld \
  -Wl,--start-group -L${MSP430_TARGET_LINKER_SCRIPT_DIR} -Wl,--end-group \
  -Wl,--cref,--map=${CMAKE_CURRENT_BINARY_DIR}/<TARGET>.map,--gc-sections -static \
  -Wl,-verbose \
  -Wl,--start-group -L${CMAKE_CURRENT_SOURCE_DIR}/lib -Wl,--end-group"
)

构建过程完全成功，终端输出的gcc命令也显示这些Flags被应用了，但就是没有生成Map文件，也没有任何错误提示。

提问：为什么Map文件没有生成？该如何修改构建脚本解决这个问题？

解决方案 #

针对问题1：让target_link_options生效的修改

问题根源在于工具链文件中硬编码了完整的链接命令，覆盖了CMake默认的链接流程，导致target_link_options设置的参数无法被注入到链接命令中。

修改方案有两种，推荐第一种：

方案1：改用CMAKE_EXE_LINKER_FLAGS_INIT替代硬编码链接命令

移除工具链文件中set(CMAKE_C_LINK_EXECUTABLE)和set(CMAKE_CXX_LINK_EXECUTABLE)的硬编码内容，改用工具链初始化变量来设置必需的链接选项：

# 移除原有的CMAKE_C_LINK_EXECUTABLE和CMAKE_CXX_LINK_EXECUTABLE设置
# 改用CMAKE_EXE_LINKER_FLAGS_INIT传递工具链级别的链接选项
set(CMAKE_EXE_LINKER_FLAGS_INIT "-T${MSP430_TARGET_LINKER_SCRIPT_DIR}/msp430g2553.ld \
  -Wl,--start-group -L${MSP430_TARGET_LINKER_SCRIPT_DIR} -Wl,--end-group \
  -static \
  -Wl,--start-group -L${CMAKE_CURRENT_SOURCE_DIR}/lib -Wl,--end-group")

这样CMake会自动将target_link_options、CMAKE_EXE_LINKER_FLAGS等所有链接相关参数合并到最终的链接命令中，你的target_link_options设置就能正常生效了。

方案2：修改硬编码链接命令，保留CMake的参数占位符

如果一定要保留CMAKE_C_LINK_EXECUTABLE的设置，必须在命令中加入CMake的标准占位符，让它能自动注入你设置的链接Flags：

set(CMAKE_C_LINK_EXECUTABLE "${CMAKE_C_COMPILER} <FLAGS> <CMAKE_C_LINK_FLAGS> <LINK_FLAGS> -o <TARGET> <OBJECTS> <LINK_LIBRARIES> \
  -T${MSP430_TARGET_LINKER_SCRIPT_DIR}/msp430g2553.ld \
  -Wl,--start-group -L${MSP430_TARGET_LINKER_SCRIPT_DIR} -Wl,--end-group \
  -static \
  -Wl,--start-group -L${CMAKE_CURRENT_SOURCE_DIR}/lib -Wl,--end-group")

其中<FLAGS>、<CMAKE_C_LINK_FLAGS>、<LINK_FLAGS>是CMake的标准占位符，会自动替换为编译Flags、CMake内置链接Flags以及你通过target_link_options设置的自定义Flags。

针对问题2：修复Map文件不生成的问题

Map文件未生成的核心原因是工具链文件中CMAKE_CURRENT_BINARY_DIR的作用域错误：工具链文件在CMake配置的早期阶段加载，此时CMAKE_CURRENT_BINARY_DIR还未指向项目的构建目录（比如build/），导致生成路径无效，Map文件可能被生成到了错误的位置（比如执行cmake命令的当前目录），或者路径解析失败。

结合问题1的解决方案，推荐在CMakeLists.txt中通过target_link_options指定Map文件路径，这样路径是绝对正确的：

# 确保MAP_FILE_OUTPUT的路径正确（你已经在CMakeLists.txt中定义了这个变量）
set(MAP_FILE_OUTPUT "${CMAKE_BINARY_DIR}/${ApplName}.map")
message(STATUS "Map-File: ${MAP_FILE_OUTPUT}")

# 通过target_link_options设置生成Map文件的选项
target_link_options(${ApplName} PRIVATE
  -Wl,--cref,--map=${MAP_FILE_OUTPUT}
  # 如果需要关闭垃圾回收，保留这个选项，否则移除（注意和工具链中的--gc-sections冲突）
  # -Wl,--no-gc-sections
)

这样修改后，链接命令会使用正确的构建目录路径生成Map文件，你可以在build/目录下找到对应的.map文件。

另外需要注意：如果工具链中设置了--gc-sections，而你又在target_link_options中设置了--no-gc-sections，两者会冲突，最终生效的是最后出现的那个选项，需要根据需求保留其中一个。

验证步骤 #

1. 彻底清理原有的构建目录：rm -rf build/
2. 重新运行CMake配置：cmake -S . -B build/ -DCMAKE_TOOLCHAIN_FILE=path/to/your/toolchain.cmake
3. 执行构建：make -C build/
4. 查看build/目录下是否生成了.map文件，同时检查终端输出的链接命令是否包含了你设置的所有Flags。

备注：内容来源于stack exchange，提问作者schnedan