如何在Cargo构建中集成自定义命令并避免触发无效重编译

你可以通过两种合规方案实现需求，都能避免不必要的项目重编译：

方案1：配置正确依赖规则的build.rs实现 #

build.rs本身完全可以实现后置处理，核心是避开「修改cargo原始构建产物」的坑，同时明确声明构建步骤的依赖追踪规则，就不会触发重编译。
具体实现要点：

• 绝对不要覆盖target目录下cargo直接生成的原始WASM文件，否则cargo校验产物哈希时会判定缓存失效，触发全量重编译
• 用cargo:rerun-if-changed指令明确告诉cargo：仅当原始WASM文件变动时，才重新执行build.rs里的wasm-opt逻辑
• wasm-opt处理后的产物输出到独立路径，需要取用的话可以额外做复制操作，复制的目标路径不要放在src等被cargo纳入源码检测的目录下
  参考实现代码：

use std::path::PathBuf;
use std::process::Command;

fn main() {
    let out_dir = PathBuf::from(std::env::var("OUT_DIR").unwrap());
    let target_dir = std::env::var("CARGO_TARGET_DIR").unwrap_or_else(|_| "target".into());
    let profile = std::env::var("PROFILE").unwrap();
    let pkg_name = std::env::var("CARGO_PKG_NAME").unwrap().replace("-", "_");
    
    // 定位cargo生成的原始WASM路径
    let original_wasm = PathBuf::from(&target_dir)
        .join("wasm32-unknown-unknown")
        .join(&profile)
        .join(format!("{}.wasm", pkg_name));
    
    // 关键：声明仅当原始WASM变动时才重跑build.rs后续逻辑
    println!("cargo:rerun-if-changed={}", original_wasm.display());

    let optimized_wasm = out_dir.join(format!("{}_opt.wasm", pkg_name));
    // 对比修改时间，避免重复执行wasm-opt
    let need_opt = if !optimized_wasm.exists() {
        true
    } else {
        let orig_meta = std::fs::metadata(&original_wasm).unwrap();
        let opt_meta = std::fs::metadata(&optimized_wasm).unwrap();
        orig_meta.modified().unwrap() > opt_meta.modified().unwrap()
    };

    if need_opt && original_wasm.exists() {
        // 按需替换为你的wasm-opt参数，包括asyncify相关配置
        let run_status = Command::new("wasm-opt")
            .arg(&original_wasm)
            .arg("-O3")
            .arg("--asyncify")
            // 可追加其他asyncify参数，比如--asyncify-ignore-imports、自定义函数白名单等
            .arg("-o")
            .arg(&optimized_wasm)
            .status()
            .expect("执行wasm-opt失败，请先安装binaryen工具链");
        assert!(run_status.success(), "wasm-opt运行异常退出");

        // 可选：把优化后的产物复制到项目dist目录方便取用
        std::fs::create_dir_all("dist").ok();
        std::fs::copy(&optimized_wasm, format!("dist/{}.wasm", pkg_name)).ok();
    }

    // 可选：导出优化后WASM的路径为环境变量，供其他流程读取
    println!("cargo:rustc-env=OPT_WASM_PATH={}", optimized_wasm.display());
}

方案2：自定义cargo子命令实现（完全不侵入构建逻辑） #

如果不想引入build.rs逻辑，可以写一个轻量的cargo自定义子命令串联构建和优化流程，完全不触碰cargo的缓存校验逻辑，100%不会触发额外重编译：

• 编写一个可执行脚本（shell/Rust/Python都可以），命名为cargo-wasm-build，放到系统PATH目录下
• 脚本逻辑：先透传所有参数执行cargo build --target wasm32-unknown-unknown，等构建完成后定位生成的原始WASM，调用wasm-opt处理后输出到指定目录
• 后续构建直接用cargo wasm-build代替原有的build命令即可
  参考shell实现：

#!/bin/bash
set -e
# 透传所有输入参数给cargo build
cargo build --target wasm32-unknown-unknown "$@"

# 自动识别构建profile
BUILD_PROFILE="release"
for arg in "$@"; do
    if [ "$arg" = "--debug" ]; then
        BUILD_PROFILE="debug"
    fi
done

# 定位原始WASM路径
PKG_NAME=$(grep "^name" Cargo.toml | head -n1 | cut -d'"' -f2 | tr '-' '_')
ORIG_WASM="target/wasm32-unknown-unknown/$BUILD_PROFILE/$PKG_NAME.wasm"
mkdir -p dist
OUT_WASM="dist/$PKG_NAME.wasm"

# 执行wasm-opt，替换为你需要的参数
wasm-opt "$ORIG_WASM" -O3 --asyncify -o "$OUT_WASM"
echo "优化完成，产物路径：$OUT_WASM"

注：所有asyncify相关的配置都可以直接通过wasm-opt的命令行参数传入，不需要依赖Cargo.toml的原生支持。

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