如何在Meson+Cargo环境下将Rust程序与指定路径的静态库链接？

问题背景 #

• 在Meson构建系统环境下，需将Meson编译生成的静态库链接到由Cargo构建的Rust crate
• 尝试通过CARGO_ENCODED_RUSTFLAGS传递'-lnative='+my_static_lib.full_path()，但Cargo提示无法找到目标静态库
• 曾测试-L指定搜索目录+-l库名的方式，但Cargo会自动添加平台特定的前缀/后缀（如Linux下的lib前缀、.a后缀，Windows下的lib前缀、.lib后缀），导致库名匹配失败
• 注意到Rust的#[link(+verbatim)]修饰符可避免名称修改，但该属性不支持env!()宏，无法动态传入库路径

可行解决方案 #

方案1：直接传递链接器原始参数

通过Rust的-C link-arg=参数，直接向底层链接器传递静态库的完整路径，绕过Cargo的库名修饰逻辑。在Meson脚本中配置环境变量：

# Meson构建脚本中设置环境变量
rustflags = f'-C link-arg={my_static_lib.full_path()}'
build_env = environment()
build_env.set('CARGO_ENCODED_RUSTFLAGS', rustflags)

# 调用cargo build时传入该环境变量
cargo_build = meson.add_run_script('cargo_build.sh', env: build_env)

此方式让链接器直接使用指定的完整路径静态库，无需担心平台名称差异。

方案2：Meson生成静态链接配置文件

通过Meson生成包含静态库路径的Rust代码文件，配合#[link(+verbatim)]使用：

1. 在Meson中生成link_config.rs：

# Meson脚本生成链接配置文件
link_config = custom_target(
    'link_config',
    output: 'link_config.rs',
    command: [
        'sh', '-c',
        f'echo "pub const STATIC_LIB_PATH: &str = \\"{my_static_lib.full_path()}\\";" > @OUTPUT@'
    ]
)

# 将生成的文件添加到Rust crate的源文件列表中
rust_crate = meson.add_library(
    'my_rust_crate',
    sources: ['src/lib.rs', link_config],
    ...
)

2. 在Rust代码中引用该配置并声明链接：

mod link_config;

#[link(name = link_config::STATIC_LIB_PATH, kind = "static", verbatim)]
extern "C" {
    // 声明静态库中的外部函数/符号
    fn my_native_function();
}

此方法通过静态生成的代码绕过env!()的限制，同时保留verbatim的特性。

方案3：动态生成Cargo配置文件

在Rust crate目录下，通过Meson动态生成.cargo/config.toml，让Cargo自动读取链接参数：

# Meson脚本生成Cargo配置
cargo_config = custom_target(
    'cargo_config',
    output: '.cargo/config.toml',
    command: [
        'sh', '-c',
        f'echo -e "[build]\\nrustflags = [\"-C\", \"link-arg={my_static_lib.full_path()}\"]" > @OUTPUT@'
    ]
)

Cargo会自动加载该配置中的rustflags，无需手动传递环境变量，适合需要持久化构建配置的场景。

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