用途:为自学习记忆项目等 Rust 工程编排构建操作,处理编译优化、工作区管理与构建错误诊断,适用于日常开发迭代、CI/CD 流水线排错和生产发布。
主要能力:按不同模式编译 Rust 工作区,包括 dev(--workspace)、release(--release --workspace)、profile(--release --timings)、check(仅类型检查)和 clean(--clean);系统化诊断编译器错误、依赖冲突、feature flag 问题及内存/超时限制;执行 clippy 检查、测试编译、release 构建校验与 stripped 二进制大小验证。
使用方式:可通过 CLI 调用,如 ./scripts/build-rust.sh dev、release、profile、check、clean。常见工作流包括完整 CI 流水线(fmt、clippy、cargo build --release --workspace、cargo test --all、cargo doc --no-deps)、快速开发循环(cargo check -p do-memory-core 等)和生产发布流程(构建后用 strip、upx、sha256sum 处理产物)。CI 中可用 actions/cache 缓存 ~/.cargo/registry,并用 CARGO_BUILD_JOBS 控制并行度。
错误处理:超时可用 CARGO_BUILD_JOBS=4;OOM 可改为 cargo build -j 1 或使用 check 模式;依赖冲突可用 cargo tree -e features、cargo update;平台缺失可用 rustup target add <triple>。
限制:资料未提供性能基准、具体耗时与体积的保证值;Verification Checklist 中 <10MB、<100ms 等仅为检查项,实际结果需自行验证。相关技能包括 code-quality、test-runner、debug-troubleshoot、github-workflows。