C#如何实现P/Invoke与Rust FFI交互来调用Rust库方法

来源:语言推理作者:台湾程序员头衔:程序员
导读:本期聚焦于小伙伴创作的《C#如何实现P/Invoke与Rust FFI交互来调用Rust库方法》,敬请观看详情,探索知识的价值。以下视频、文章将为您系统阐述其核心内容与价值。如果您觉得《C#如何实现P/Invoke与Rust FFI交互来调用Rust库方法》有用,将其分享出去将是对创作者最好的鼓励。

在跨语言开发需求中,使用Rust编写高性能核心逻辑,再通过C#构建上层应用是常见方案,实现两者的交互需要借助Rust的FFI能力和C#的P/Invoke机制。Rust可以编译为符合C ABI的动态链接库,C#则通过P/Invoke声明对应函数签名来完成调用,整个过程需要保证两端的数据类型和调用约定完全匹配。

C#如何实现P/Invoke与Rust FFI交互来调用Rust库方法

Rust端编写可导出函数

Rust默认的函数使用Rust特有的ABI,无法被其他语言直接调用,需要显式指定使用C ABI,并且将函数标记为导出。同时要注意Rust的基础类型和C类型的内存布局对齐,避免调用时出现内存错误。

首先创建一个新的Rust库项目,在Cargo.toml中配置库类型为cdylib,这样编译后会生成对应平台的动态链接库:

[package]
name = "rust_lib"
version = "0.1.0"
edition = "2021"

[lib]
crate-type = ["cdylib"]

接下来编写导出的函数,示例实现一个简单的加法函数和一个返回字符串的函数:

// 标记函数使用C ABI,no_mangle避免函数名被混淆
#[no_mangle]
pub extern "C" fn add(a: i32, b: i32) -> i32 {
    a + b
}

// 返回C兼容的字符串,需要手动管理内存
#[no_mangle]
pub extern "C" fn get_greeting() -> *mut std::os::raw::c_char {
    let greeting = "Hello from Rust";
    // 将Rust字符串转换为C字符串
    let c_str = std::ffi::CString::new(greeting).unwrap();
    // 返回指针,所有权转移给调用方
    c_str.into_raw()
}

// 释放C字符串内存的函数,避免内存泄漏
#[no_mangle]
pub extern "C" fn free_str(s: *mut std::os::raw::c_char) {
    if s.is_null() {
        return;
    }
    // 重新构建CString并drop,释放内存
    unsafe {
        std::ffi::CString::from_raw(s);
    }
}

在Windows平台执行cargo build --release会生成rust_lib.dll,Linux平台生成librust_lib.so,macOS平台生成librust_lib.dylib。

C#端使用P/Invoke声明函数

C#通过System.Runtime.InteropServices命名空间下的特性来声明P/Invoke函数,需要保证函数签名、调用约定、数据类型和Rust端完全匹配。

首先创建C#控制台项目,添加对应的函数声明:

using System;
using System.Runtime.InteropServices;

class RustLib
{
    // 根据平台指定动态库名称,Windows用rust_lib.dll,Linux用librust_lib.so,macOS用librust_lib.dylib
    private const string LibName = "rust_lib";

    // 声明add函数,调用约定使用Cdecl和Rust端匹配
    [DllImport(LibName, CallingConvention = CallingConvention.Cdecl)]
    public static extern int add(int a, int b);

    // 声明get_greeting函数,返回IntPtr对应C的指针
    [DllImport(LibName, CallingConvention = CallingConvention.Cdecl)]
    public static extern IntPtr get_greeting();

    // 声明free_str函数,释放Rust分配的内存
    [DllImport(LibName, CallingConvention = CallingConvention.Cdecl)]
    public static extern void free_str(IntPtr s);
}

接下来在Main方法中调用这些函数:

class Program
{
    static void Main()
    {
        // 调用加法函数
        int result = RustLib.add(10, 20);
        Console.WriteLine($"10 + 20 = {result}");

        // 调用返回字符串的函数
        IntPtr ptr = RustLib.get_greeting();
        // 将IntPtr转换为C#字符串
        string greeting = Marshal.PtrToStringAnsi(ptr);
        Console.WriteLine($"Greeting: {greeting}");
        // 释放Rust分配的内存
        RustLib.free_str(ptr);
    }
}

将编译好的Rust动态库放到C#可执行文件同目录下,运行C#程序即可看到正确的输出结果。

注意事项

  • 数据类型匹配:Rust的i32对应C#的int,Rust的c_char指针对应C#的IntPtr,不要随意使用不匹配的类型,否则会导致内存错误。
  • 内存管理:Rust分配的内存必须由Rust释放,C#端不要尝试释放Rust返回的指针,否则会出现双重释放的问题。
  • 调用约定:Rust的extern "C"默认使用Cdecl调用约定,C#端DllImport也要指定CallingConvention为Cdecl,否则会出现栈不平衡的错误。
  • 字符串处理:Rust返回的字符串需要转换为C兼容的字符串,C#端使用Marshal类的方法转换为托管字符串,不要直接操作指针。

常见问题排查

如果调用时出现找不到动态库的错误,需要检查动态库是否放在正确的路径下,或者是否安装了对应平台的运行时依赖。如果出现函数调用崩溃,优先检查函数签名是否匹配,调用约定是否正确,数据类型是否对齐。如果返回字符串出现乱码,需要确认字符串的编码是否一致,Rust端默认生成的是UTF-8编码的C字符串,C#端使用PtrToStringAnsi可以正确转换。

C#RustFFIP/Invoke动态链接库修改时间:2026-06-18 08:42:38

免责声明:​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰,观点力求客观中立。本站旨在免费分享,内容仅供个人学习、研究或参考使用。若引用了第三方作品,版权归原作者所有。如内容涉及您的权益,请联系我们处理。
内容垂直聚焦
专注技术核心技术栏目,确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计,为用户提供无干扰的纯技术知识沉淀,精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进,构建清晰学习路径,帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈,深入技术细节与实践难点。无论是数据库优化还是服务器配置,均结合真实场景与代码示例进行剖析,致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程,从数据库操作到服务器运维,形成完整闭环,一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性,步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目,显著缩短从学习到实践的距离,快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代,紧跟主流技术发展趋势,为用户提供经久不衰的学习价值。