已安装wasm32-wasi，为何cargo build --target wasm32-wasi仍报错？

问题背景 #

执行cargo build --target wasm32-wasi构建Rust项目时，明明已通过rustup target add wasm32-wasi确认目标组件已安装，却仍抛出以下错误：

➜  train git:(master) ✗ cargo build --target wasm32-wasi
   Compiling train v0.1.0 (/user/playground/rustLang/train)
error[E0463]: can't find crate for `std`
  |
  = note: the `wasm32-wasi` target may not be installed
  = help: consider downloading the target with `rustup target add wasm32-wasi`

error: cannot find macro `println` in this scope
 --> src/main.rs:2:5
  |
2 |     println!("hello");
  |     ^^^^^^^

error: requires `sized` lang_item

For more information about this error, try `rustc --explain E0463`.
error: could not compile `train` due to 3 previous errors
➜  train git:(master) ✗ rustup target add wasm32-wasi
info: component 'rust-std' for target 'wasm32-wasi' is up to date

复现步骤：

• 执行cargo new train创建项目
• 执行rustup target add wasm32-wasi安装目标
• 执行cargo build --target wasm32-wasi构建

解决方法 #

1. 校验工具链与目标组件版本匹配 #

运行rustup show查看当前活跃工具链的版本，确认rust-std for wasm32-wasi的版本与当前rustc版本完全一致。若版本不一致，说明工具链更新后目标组件未同步更新。

• 同步更新工具链：
  • 稳定版：rustup update stable
  • Nightly版：rustup update nightly

2. 确认目标组件安装到当前活跃工具链 #

部分场景下，目标组件可能被安装到了非当前活跃的工具链（比如安装到Nightly但当前用的是Stable）。运行rustup target list --installed查看当前工具链下已安装的目标，确认wasm32-wasi在列表中。

• 若未找到，指定工具链安装目标：
  rustup target add wasm32-wasi --toolchain <你的工具链版本>
  示例：rustup target add wasm32-wasi --toolchain stable

3. 检查项目工具链配置文件 #

如果项目根目录存在rust-toolchain或rust-toolchain.toml文件，其中指定的工具链版本可能与安装目标组件的工具链不一致。查看文件内容，确认工具链版本后，为该版本安装wasm32-wasi目标。

4. 清理Cargo缓存后重试 #

Cargo缓存异常也可能导致此类问题，执行以下命令清理缓存后重新构建：

cargo clean
cargo build --target wasm32-wasi

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