Rust项目lib.rs中move_to_built函数导入失败问题求助

问题场景 #

项目结构 #

src
├── display
│  └── mod.rs
├── lib.rs
├── main.rs
└── tetromino
   ├── characters.rs
   ├── line.rs
   ├── mod.rs
   └── tetromino.rs

问题描述 #

在lib.rs中定义了公共函数move_to_built：

pub fn move_to_built(
    tetromino: &mut Tetromino,
    built_tetrominoes: &mut [[TetrominoCharacter; WIDTH]; HEIGHT],
) {
    // 函数实现代码
}

在display/mod.rs中通过use crate::move_to_built;导入该函数时，出现错误：

unresolved import `crate::move_to_built`
no `move_to_built` in the root

修复方案 #

1. 确认函数的作用域层级 #

确保move_to_built直接定义在lib.rs的根作用域中，没有被嵌套在私有模块、mod块或函数内部。如果函数被放在子模块里，需调整导入路径：

// 若lib.rs中函数嵌套在子模块：
mod game {
    pub fn move_to_built(...) { /* ... */ }
}

// 则display/mod.rs的导入路径应为：
use crate::game::move_to_built;

2. 验证Cargo.toml配置 #

检查项目Cargo.toml，确保没有错误配置导致lib.rs未被识别为库crate入口。同时包含main.rs（二进制入口）和lib.rs（库入口）的项目，Cargo会自动识别，无需额外配置；若手动修改过[[bin]]或[lib]字段，需保证配置正确：

[package]
name = "your_crate_name"
version = "0.1.0"

3. 使用 crate 名称替代crate关键字（可选） #

若存在二进制与库的优先级问题，可直接用Cargo.toml中name字段指定的crate名称导入：

// 假设Cargo.toml中name = "tetris_game"
use tetris_game::move_to_built;

4. 清理构建缓存 #

构建缓存可能导致模块解析异常，执行以下命令清理并重新构建：

cargo clean
cargo build

5. 检查相关类型的导出 #

确保Tetromino、TetrominoCharacter等依赖类型已在lib.rs中正确导出，避免因类型未公开引发间接错误：

// lib.rs中导出相关类型
pub use tetromino::Tetromino;
pub use tetromino::characters::TetrominoCharacter;

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