搭建首个Substrate链执行cargo build命令遇错误求解决

1. 校验Rust工具链版本 #

Substrate对Rust版本有严格要求，必须匹配指定的nightly版本：

rustup update nightly
rustup target add wasm32-unknown-unknown --toolchain nightly
rustup override set nightly

2. 清理依赖缓存后重建 #

依赖缓存损坏是常见诱因，执行以下命令重置缓存：

cargo clean
rm -rf ~/.cargo/git
rm -rf ~/.cargo/registry
cargo build

3. 补全系统依赖 #

不同系统需要安装对应的基础编译库：

• Ubuntu/Debian：

  sudo apt update && sudo apt install -y git clang curl libssl-dev llvm libudev-dev make
  

• macOS：

  brew install openssl llvm
  

4. 缓解内存不足问题 #

如果构建时出现内存溢出，限制并行构建任务数：

CARGO_BUILD_JOBS=2 cargo build

也可以通过添加swap分区临时扩充内存。

5. 匹配教程代码版本 #

确保项目代码与教程指定版本一致，进入项目目录后切换到对应commit：

git checkout <教程中给出的commit哈希>

再重新执行cargo build

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