用途:build-rust 是该项目的构建入口脚本,围绕 Rust workspace 提供开发、生产、性能分析与校验等构建方式。
主要能力:脚本支持多种模式——dev(快速开发,含调试符号)、release(优化并剥离符号的生产构建)、profile(通过 --timings 做性能分析)、check(仅做快速类型检查)、clean(清理产物),并可指定具体 crate,例如 ./scripts/build-rust.sh release do-memory-core。
使用方式:基本调用为 ./scripts/build-rust.sh 加模式名。清理产物可用 ./scripts/clean-artifacts.sh quick|standard|full;如需转移目标目录可设置 CARGO_TARGET_DIR=/mnt/fastssd/rslm-target ./scripts/build-rust.sh dev。常见流程包括 CI:先 fmt 与 clippy,再 cargo build --release --workspace 与测试;快速开发可用 cargo check -p 与 cargo test -p --lib。
磁盘优化:依据 ADR-032,dev profile 可把 target/ 体积从约 5.2 GB 降到约 2 GB,做法是 debug = "line-tables-only"、依赖不生成调试信息、用 build-override 提高 opt-level。
错误处理与排障:超时可设 CARGO_BUILD_JOBS=4 或改用 check;内存不足可用 -j 1;依赖冲突先 cargo update 再 cargo tree -d;交叉编译需 rustup target add x86_64-unknown-linux-musl;增量缓存损坏执行 cargo clean;锁文件过期可删除并重新生成;工具链不匹配则更新 stable。
校验要点:构建完成且无 clippy 警告、测试可编译、剥离后二进制小于 10MB、启动低于 100ms。相关 ADR 为 032(磁盘空间)与 036(依赖去重)。
限制:以上信息来自项目自身文档,未提供其他平台支持、收费或许可等细节。