Windows下CMake编译C++与NASM项目报LNK2019错误如何解决

这是Windows x86平台下C++与NASM汇编混合编程的典型符号修饰不匹配错误：

• 32位(x86)模式下的MSVC编译器，默认对extern "C"声明的函数自动加_前缀，因此C++代码中调用的asm_foo在链接阶段会查找名为_asm_foo的外部符号
• 汇编代码默认按类Unix平台的ELF格式规则编译，导出的符号没有加_前缀，目标文件中仅存在asm_foo符号，两边符号名不一致就会触发LNK2019错误。
  注意：64位(x64)模式下的MSVC不会给C函数加下划线前缀，该问题仅出现在32位x86编译场景中。

按兼容性优先级排序，可选择以下任意一种方案修复：

方案1：CMake层做跨平台适配（推荐，兼容多平台编译） #

通过CMake判断目标平台，自动给NASM传递对应编译参数，无需为不同平台维护多份汇编代码：

1. 首先确认CMakeLists.txt开头正确声明了NASM语言支持：

   project(你的项目名称 C CXX ASM_NASM)
   

2. 在CMakeLists.txt中添加平台判断逻辑，给NASM设置对应输出格式和预处理宏：

   if(WIN32)
       if(CMAKE_SIZEOF_VOID_P EQUAL 4)
           # 32位Windows：指定输出win32目标格式，传递下划线前缀的预处理宏
           set(CMAKE_ASM_NASM_FLAGS "-f win32 -dWIN32_X86_PREFIX")
       else()
           # 64位Windows：指定输出win64目标格式
           set(CMAKE_ASM_NASM_FLAGS "-f win64")
       endif()
   endif()
   

3. 修改NASM汇编代码，用宏统一包裹导出符号名，自动适配不同平台的修饰规则：

   ; 统一处理不同平台的符号前缀
   %ifdef WIN32_X86_PREFIX
       %define C_SYM(name) _ %+ name
   %else
       %define C_SYM(name) name
   %endif
   
   ; 声明导出函数
   global C_SYM(asm_foo)
   
   ; 函数实现
   C_SYM(asm_foo):
       ; 此处填写汇编逻辑
       ret
   

4. 确认C侧的汇编函数声明添加了extern "C"，避免C名字修饰打乱符号：

   extern "C" void asm_foo();
   
   int main() {
       asm_foo();
       return 0;
   }
   

方案2：直接修改汇编符号名（快速修复，仅适配32位Windows） #

如果仅需要在32位Windows MSVC环境下编译，不需要跨平台兼容，可以直接修改汇编文件中的符号名，给导出函数加_前缀：

; 原代码
; global asm_foo
; asm_foo:

; 修改为
global _asm_foo
_asm_foo:
    ; 函数逻辑不变
    ret

注意：该修改会导致代码在x64 Windows、Linux等平台编译时反过来出现符号找不到的错误，仅适合临时验证场景使用。

方案3：调整MSVC编译选项（不推荐） #

可以通过给MSVC传递对应参数关闭默认的下划线前缀修饰，但该方案会修改编译器默认调用约定，极易引发和系统库、第三方依赖的ABI兼容问题，非特殊场景不建议使用。

修改完成后按以下步骤验证，避免缓存导致问题复现：

• 完全删除之前的build构建目录，重新执行CMake配置和全量编译
• 如果仍有符号错误，可以用VS自带的dumpbin工具核对两边符号：
  • 执行dumpbin /symbols cpp.obj | findstr asm_foo查看C++目标文件依赖的符号名
  • 执行dumpbin /symbols 汇编生成的目标文件.obj | findstr asm_foo查看汇编目标文件导出的符号名
  • 两边输出的符号名完全一致即可正常链接

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