rust-errors-build-link

用途：诊断并修复 Rust 构建与链接阶段的错误，包括链接器缺失、原生库失败、重复符号冲突、MSRV 不匹配以及特性统一带来的意外行为。这些错误来自 Cargo、rustc、系统链接器和构建脚本，各有不同根因与确定性修复方式，不应把 cargo clean 当作首选。

主要能力与用法：

1. 链接器缺失（linker cc not found）：说明机器缺少 C 工具链，按系统安装，如 Debian/Ubuntu 用 sudo apt install build-essential，macOS 用 xcode-select --install，Windows MSVC 需安装带 C++ 工作负载的 Visual Studio Build Tools。
2. 未定义引用（undefined reference to）：常见原因是缺少原生库、缺少 -dev/-devel 包或链接顺序错误。可在 build.rs 中用 println!("cargo::rustc-link-lib=dylib=z") 或 static=foo 声明链接。
3. 找不到原生静态库：需补充搜索路径，如 println!("cargo::rustc-link-search=native=/usr/local/lib")；-sys crate 通常读取 <NAME>_LIB_DIR、<NAME>_INCLUDE_DIR 等环境变量。
4. 重复符号：多因同一 links crate 存在两个大版本，先用 cargo tree -d 与 cargo tree -i <crate> 诊断，再优先升级滞后依赖或使用 cargo update -p <crate> --precise <version>，必要时用 [patch.crates-io]。
5. MSRV 不匹配：可 rustup update stable，或将依赖固定到较旧版本；Rust 1.84+ 可用 resolver = "3" 与 rust-version。
6. 特性统一：用 cargo tree -f "{p} {f}" 或 cargo tree -e features 定位启用者；特性是叠加的，无法禁用其他 crate 所需特性。

限制与注意：始终阅读完整错误块，note: 行才含真实链接器诊断；不要例行执行 cargo clean，不要用 =x.y.z 规避版本冲突，也不要在运行时用 LD_LIBRARY_PATH 掩盖链接配置问题。cargo clean 仅适用于缓存损坏等少数情况。资料未提供收费、价格与平台信息。