Rust中函数参数的GenericSemaphore缺失泛型参数如何指定

GenericSemaphore是futures-intrusive库提供的泛型信号量实现，定义时要求传入1个实现了RawMutex trait的锁类型作为泛型参数，用于适配不同运行时、不同线程安全要求的场景。未指定该泛型参数时就会触发E0107编译错误。
之前尝试传入std::sync::Mutex、tokio::sync::Mutex等类型失败，是因为这些类型没有实现该库要求的RawMutex trait，不符合泛型约束。

直接使用库官方预定义的类型别名即可，不需要手动填写泛型参数，覆盖绝大多数使用场景：

• 多线程异步场景（绝大多数服务端场景、Tokio/async-std多线程运行时）：使用futures_intrusive::sync::Semaphore，本质是GenericSemaphore<RawMutex>，实现了Send+Sync，线程安全
• 单线程异步场景（WASM、单线程本地执行器）：使用futures_intrusive::sync::LocalSemaphore，非线程安全，运行开销更低

修改后的代码示例：

use std::path::Path;
// 直接引入预定义的线程安全Semaphore
use futures_intrusive::sync::Semaphore;

// 原代码使用了?传播错误，需要补充Result返回值
async fn refresh_file(
    raster_file: &Path,
    slr: f64,
    output_path: &Path,
    chunk_size: u32,
    semaphore: &Semaphore
) -> std::io::Result<()> {
    if !output_path.exists() {
        build_required_windows(&raster_file, slr, chunk_size, output_path, semaphore).await?;
    }
    Ok(())
}

如果有自定义锁的需求，需要手动指定泛型参数时，先引入对应实现了RawMutex trait的锁类型，再填入泛型位即可，示例：

use std::path::Path;
use futures_intrusive::sync::{GenericSemaphore, RawMutex};

async fn refresh_file(
    raster_file: &Path,
    slr: f64,
    output_path: &Path,
    chunk_size: u32,
    // 手动指定泛型参数为库自带的RawMutex
    semaphore: &GenericSemaphore<RawMutex>
) -> std::io::Result<()> {
    if !output_path.exists() {
        build_required_windows(&raster_file, slr, chunk_size, output_path, semaphore).await?;
    }
    Ok(())
}

• 官方自带的RawMutex可以兼容Tokio、async-std等所有主流异步运行时，不需要特意替换为运行时自带的锁类型
• 初始化信号量时，对应使用所选类型即可，比如多线程场景初始化：let semaphore = Semaphore::new(true, max_permits);，第一个参数表示是否开启公平调度
• 原代码中函数使用?传播错误但未声明Result返回值，修复泛型问题后需要补上对应返回类型，否则会触发新的编译错误

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