基于 rs-project-template 生成的 Rust 项目。
- Tokio 异步运行时
- Tracing 结构化日志
- Jemalloc 内存分配器(非 MSVC 平台)
- pprof 内存分析支持(按需开启)
- 跨平台交叉编译支持(macOS / Linux / Windows)
| 平台 | 目标三元组 | 架构 | 构建方式 |
|---|---|---|---|
| macOS | aarch64-apple-darwin |
ARM64 | Docker (cargo-zigbuild) |
| macOS | x86_64-apple-darwin |
x86_64 | Docker (cargo-zigbuild) |
| Linux | x86_64-unknown-linux-musl |
x86_64 | Docker (cargo-zigbuild) |
| Windows | x86_64-pc-windows-msvc |
x86_64 | Docker (cargo-xwin) |
Linux 使用 musl 静态链接,生成的二进制无 glibc 依赖,可在任意 Linux 发行版(含 CentOS 7)上运行。
# 从模板生成新项目
cargo generate --git https://github.com/wpf375516041/rs-project-template
# 构建
cargo build -r --bin main
# 运行
cargo run -r --bin main# 查看所有可用命令
just
# 构建当前平台
just build
# 构建 release 版本
just build-release
# 交叉编译所有平台
just build-all-release
# 交叉编译单个平台
just build-macos-arm64-release
just build-macos-x86_64-release
just build-linux-x86_64-release
just build-windows-x86_64-release
# 运行测试
just test
# 代码检查
just lint
# 格式化检查
just fmt交叉编译的 Docker 工具链缓存支持两种位置,通过 CROSS_CACHE_MODE 环境变量控制:
| 模式 | 缓存位置 | 说明 |
|---|---|---|
shared(默认) |
~/.docker-rust-cross |
所有项目共享,节省磁盘和首次构建时间 |
project |
项目内 .docker-rust |
项目独立缓存,适合 CI 或需隔离的场景 |
生成项目时 cargo generate 会提示选择,结果写入 .env。运行时也可覆盖:
# 使用 .env 中的配置
just build-linux-x86_64
# 临时切换为项目级缓存
CROSS_CACHE_MODE=project just build-linux-x86_64- Windows (MSVC): Jemalloc 和 pprof 不可用,自动回退到系统默认内存分配器。
- macOS / Linux: 完整功能,包括 Jemalloc 内存分配器和 pprof 分析支持。