Rust执行cargo build报use of undeclared crate错误如何解决

根因分析 #

你遇到的编译错误由配置问题导致：

• Cargo.toml中rust-ini依赖被标记为optional = true，默认状态下可选依赖不会被纳入编译链路，因此编译器无法识别对应的crate
• IntelliJ Rust插件会索引所有本地已下载的依赖包，不受可选依赖开关限制，所以你在IDE中可以正常跳转到定义，和编译结果不一致属于正常现象

修复步骤 #

方案一：无需可选依赖（通用场景） #

直接修改Cargo.toml的依赖配置，删除optional = true标记即可：

[dependencies]
rust-ini = "0.17.0"

修改完成后执行cargo build即可正常编译。

方案二：需要保留可选依赖 #

如果你有功能裁剪需求必须保留可选依赖配置，需要额外在Cargo.toml中添加feature规则关联该依赖：

[features]
# 可根据需求决定是否默认启用ini依赖
default = ["ini"]
ini = ["dep:rust-ini"]

如果没有在default中启用ini feature，编译时需要指定参数引入依赖：cargo build --features ini。

如果修改后仍然报错，可先执行cargo clean清理编译缓存后再重新执行编译命令。

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