Anchor项目构建报错：cargo-build-sbf及目标支持问题排查

问题场景与报错详情 #

1. 初始构建报错 #

执行以下命令创建并构建Anchor项目：

anchor init AnchorProject
cd AnchorProject
anchor build

出现报错：

admin@Desktop MINGW64 /d/folder_1/MY_Project/AnchorProject (main)
$ anchor build

Warning: cargo-build-bpf is deprecated. Please, use cargo-build-sbf

cargo-build-bpf child: 
C:\Users\admin\.local\share\solana\install\active_release\bin\cargo-build-sbf.exe --arch bpf

[2022-09-23T17:22:59.130309300Z ERROR cargo_build_sbf] Failed to obtain package metadata: 

`cargo metadata` exited with an error: error: failed to load manifest for workspace member

 `\\?\D:\folder_1\MY_Project\AnchorProject\programs\*`
    
    Caused by:
      failed to read `\\?\D:\folder_1\MY_Project\AnchorProject\programs\*\Cargo.toml`

    Caused by:
      The filename, directory name, or volume label syntax is incorrect. (os error 123)

疑问：报错中的\\?\是什么含义？

2. 解决元数据问题后的新报错 #

解决上述元数据问题后，再次执行anchor build出现新报错：

$anchor build

error: no such subcommand: build-bpf 

Did you mean build-sbf?

3. 错误命令导致的编译失败 #

尝试输入错误命令cargo-build-bfs后，出现以下报错：

$cargo-build-bfs

info: uninstalling toolchain 'sbf'
info: toolchain 'sbf' uninstalled
   Compiling getrandom v0.1.16
   Compiling memchr v2.5.0
   Compiling bv v0.11.1
   Compiling quote v1.0.21
   Compiling rustversion v1.0.9
   Compiling blake3 v1.3.1
error: target is not supported
   --> src\lib.rs:267:9
    |
267 | /         compile_error!("\
268 | |             target is not supported\
269 | |         ");
    | |__________^

error[E0433]: failed to resolve: use of undeclared crate or module `imp`
   --> src\lib.rs:291:5
    |
291 |     imp::getrandom_inner(dest)
    |     ^^^ use of undeclared crate or module `imp`

For more information about this error, try `rustc --explain E0433`.                           
error: could not compile `getrandom` due to 2 previous errors                                
warning: build failed, waiting for other jobs to finish...

解决方案 #

1. 关于\\?\路径前缀的含义 #

\\?\是Windows系统的长路径支持前缀，用来绕过传统Windows路径260字符的长度限制。报错里出现这个前缀是因为Anchor在Windows环境下解析路径时，错误地将programs\*中的通配符*当成了路径的一部分，导致无法定位到正确的Cargo.toml文件，触发了路径语法错误（os error 123）。

2. 解决初始元数据报错 #

• 检查项目路径：确保路径中没有空格、中文或特殊字符，Windows环境下这类字符容易导致路径解析异常。
• 验证programs目录：确认programs目录下存在正确的子项目（比如anchor init默认创建的anchor_project目录），且该子项目下有合法的Cargo.toml文件，没有路径通配符问题。
• 版本兼容：确保Anchor CLI和Solana工具链版本匹配，避免因版本差异导致的路径解析bug。

3. 解决no such subcommand: build-bpf报错 #

Solana已废弃cargo-build-bpf命令，替换为cargo-build-sbf。解决方法：

• 更新Solana工具链到最新稳定版：

  solana-install update
  

• 更新Anchor CLI到兼容版本：

  cargo install --git https://github.com/coral-xyz/anchor anchor-cli --locked
  

  更新后重新执行anchor build即可自动调用cargo-build-sbf。

4. 解决错误命令导致的编译失败 #

由于输入了错误的cargo-build-bfs命令，导致sbf工具链被误卸载。恢复步骤：

• 重新安装Solana稳定版工具链：

  solana-install init stable
  

• 确保使用正确的命令：构建项目用anchor build，或者直接调用cargo build-sbf（需进入具体程序目录）。

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