如何用cxx将Rust的Vec<[T; N]>绑定到C++？

我正在用cxx为C++库编写Rust封装，库中频繁用到可变长度向量，元素为固定大小数组（比如存储N个三维点的向量，每个点是3个double组成的数组）。

尝试直接绑定Rust的Vec<[u64; 3]>到C++的rust::Vec<std::array<uint64_t, 3>>，代码如下：

// main.rs
include!("include/foo.h");
#[cxx::bridge]
pub mod ffi {
    unsafe extern "C++" {
        fn foo(x: Vec<[u64; 3]>);
    }
}

// foo.h
void foo(rust::Vec<std::array<uint64_t, 3>> x);

但编译时触发错误：

error[cxxbridge]: unsupported element type of Vec
     ┌─ src/main.rs:17:19
     │
 17 │         fn foo(x: Vec<[u64; 3]>);
     │                   ^^^^^^^^^^^^^ unsupported element type of Vec

现有的两种解决方案都不够理想：

• 创建桥接专用结构体（比如Point3D），用Vec<Point3D>替代，但每种数组变体都要新建结构体，冗余繁琐。
• 将数据扁平化为Vec<u64>后再转换为目标类型，可行但额外步骤多。

希望找到更简洁的实现方式，避免重复冗余代码。

cxx crate原生支持cxx::Array<T, N>类型，它可以直接对应C++的std::array<T, N>，且是零开销的（内存布局完全一致）。我们可以用Vec<cxx::Array<u64, 3>>来替代Vec<[u64; 3]>，这样就能直接完成绑定，无需额外结构体或数据转换。

修改后的代码如下：

Rust 端（main.rs） #

include!("include/foo.h");
#[cxx::bridge]
pub mod ffi {
    // 导入cxx提供的Array类型
    use cxx::Array;

    unsafe extern "C++" {
        fn foo(x: Vec<Array<u64, 3>>);
    }
}

// 零开销转换函数：将Rust原生Vec<[u64;3]>转为cxx兼容类型
// 内存布局完全一致，仅做类型标记转换
fn convert_to_cxx_vec(points: Vec<[u64; 3]>) -> Vec<cxx::Array<u64, 3>> {
    unsafe { std::mem::transmute(points) }
}

C++ 端（foo.h） #

#include <array>
#include "rust/cxx.h"

void foo(rust::Vec<std::array<uint64_t, 3>> x);

方案优势 #

1. 零开销：cxx::Array<T,N>与Rust原生[T;N]、C++std::array<T,N>内存布局完全一致，转换时无需拷贝数据。
2. 无冗余结构体：直接复用cxx提供的通用数组类型，不用为每种数组维度新建桥接结构体。
3. 使用体验接近原生：如果需要在Rust中频繁操作这类数组，还可以给cxx::Array<T,N>实现Deref trait，让它支持索引、切片等原生数组操作：

use std::ops::{Deref, DerefMut};

impl<T, const N: usize> Deref for cxx::Array<T, N> {
    type Target = [T; N];
    fn deref(&self) -> &Self::Target {
        unsafe { &*(self as *const _ as *const [T; N]) }
    }
}

impl<T, const N: usize> DerefMut for cxx::Array<T, N> {
    fn deref_mut(&mut self) -> &mut Self::Target {
        unsafe { &mut *(self as *mut _ as *mut [T; N]) }
    }
}

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