You need to enable JavaScript to run this app. Windows下编译可供Raku NativeCall调用的DLL库出现error 0xc1报错的问题
优惠活动
大模型
产品
解决方案
定价
更多

Windows下编译可供Raku NativeCall调用的DLL库出现error 0xc1报错的问题

问题根因
  • 报错信息里的error 0xc1对应Windows系统错误ERROR_BAD_EXE_FORMAT,代表当前要加载的DLL文件格式和Raku进程的要求不匹配;而显示的Cannot locate native library '(null)'并不是真的找不到你写的DLL路径,是因为DLL加载失败后,NativeCall拿到的模块句柄为空,所以用(null)做占位文本。
  • 最常见的触发原因是32/64位不匹配:你打开的VS 2019开发者命令提示符如果是默认的x86 32位环境,编译出的就是32位DLL;如果你的Rakudo是64位版本,完全无法加载32位DLL,就会直接报这个格式错误。
  • 手动分两步跑编译、链接命令的流程有缺陷:手动执行cl /c生成obj后再单独跑link /DLL,很容易漏掉C运行库的自动链接参数,导致生成的DLL导入表不完整,无法正常加载。
  • 代码写法存在冗余问题:定义了EXPORTED宏但没在实际函数定义上使用,仅靠extern声明加导出标记,容易出现声明和定义的属性不一致问题。
  • 其他触发场景:如果生成的DLL缺少对应版本的VC运行库依赖,也会因为无法解析依赖项导致加载失败,出现同样的报错。
解决操作步骤
  • 第一步:确认Rakudo的位宽
    在系统命令行执行raku -e "$*VM.config<arch>",根据输出结果确定编译的目标位宽:
    • 输出MSWin32-x64则必须编译64位DLL
    • 输出MSWin32-x86则必须编译32位DLL
  • 第二步:打开对应位宽的VS编译环境
    关闭当前打开的开发者命令提示符,从VS 2019开始菜单里选择匹配位宽的命令提示符快捷方式:
    • 64位目标选"x64 Native Tools Command Prompt for VS 2019"
    • 32位目标选"x86 Native Tools Command Prompt for VS 2019"
  • 第三步:修正C代码的导出写法
    把my_c_dll.c里的冗余内容删掉,改成直接在函数定义上加导出标记的规范写法:
    #include <stdio.h>
    
    __declspec(dllexport) void foo()
    {
      printf("Hello from C\n");
    }
    
  • 第四步:单步编译生成DLL
    不要分开手动跑cl /c和link /DLL,直接在对应环境的命令行执行单条编译命令,让编译器自动处理所有链接依赖:
    cl /LD my_c_dll.c /Fe:my_c_dll.dll
    
    参数说明:
    • /LD 会自动完成DLL所需的编译、链接全流程,不需要手动拆分步骤
    • /Fe 指定最终输出的DLL文件名称
    • 可选优化:如果希望避免C运行库的外部依赖,可以给编译命令加上/MT参数静态链接CRT,生成的DLL无需额外安装VC运行库即可运行。
  • 第五步:验证DLL导出表
    执行dumpbin /exports my_c_dll.dll,确认导出函数列表里存在foo函数,没有导出异常。
  • 第六步:运行Raku测试脚本
    保持test-dll.raku里的native路径写法不变(./my_c_dll.dll会优先匹配当前工作目录下的DLL,写法正确),执行raku test-dll.raku,即可正常看到C函数打印的Hello from C输出。

内容的提问来源于stack exchange,提问作者Håkon Hægland

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 04:36:01