如何在MASM中引用外部C++函数？VS2019调用writei遇未解析符号错误

你遇到的核心问题是**C++的名字修饰（Name Mangling）**导致链接器找不到writei函数，再加上一些x64调用规范的细节问题，我来一步步帮你解决：

1. 给C++函数加上extern "C"修饰 #

C编译器会对函数名进行特殊修饰（比如把writei改成类似?writei@@YAH_K@Z的格式），而MASM里你用extrn writei:proto声明的是未修饰的C风格名字，链接器自然匹配不上。修改你的C代码：

extern "C" int writei(uint64_t a) {
    cout << a;
    return 1;
}

extern "C"会强制编译器采用C风格的命名规则，不再做名字修饰，这样MASM里的writei就能和它正确对应。

2. 修正MASM代码的调用细节 #

在Visual Studio的x64环境中，默认遵循Microsoft x64调用约定，还有几个细节需要调整：

externdef writei : proto : qword  ; 明确参数为qword类型（对应C++的uint64_t）
.code
main proc  ; 入口函数名应为main，不是mai
    push rbp
    mov rbp, rsp
    sub rsp, 32h  ; 调整栈到16字节对齐，同时预留x64要求的阴影空间
    
    mov rcx, 3    ; 64位参数要放在rcx寄存器，不能只传低32位的ecx
    call writei
    
    add rsp, 32h  ; 恢复栈空间
    pop rbp
    ret
main endp
end

关键细节说明： #

• 用externdef代替extern，这是MASM中声明外部函数的推荐写法，同时明确参数类型为qword，和C++的uint64_t匹配。
• x64调用要求栈在调用函数前必须是16字节对齐，push rbp后rsp偏移了8字节，所以通过sub rsp, 32h完成对齐，同时满足调用约定要求的32字节阴影空间。
• 传递64位参数必须用rcx寄存器，虽然小数值用ecx暂时能工作，但不符合规范，处理大数值时会出错。

3. 检查Visual Studio项目配置 #

最后确认项目设置没问题：

• 右键MASM文件→属性→常规，把项类型设置为Microsoft Macro Assembler。
• 确保C++文件和MASM文件都在同一个项目中，且都被包含在编译流程里（没有被排除）。
• 确认项目平台是x64（你用了64位类型和寄存器，不能用Win32平台）。

按照这些步骤修改后，链接器就能找到writei函数，调用也能正常运行了。

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