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

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可以正确转换。