basic/crate-module/use

[giscus[bot]]

basic/crate-module/use

https://course.rs/basic/crate-module/use.html

[SifungLei]

有点复杂。

[caoxiemeihao]

+10086

[SifungLei]

这里内容不够全。建议介绍不同目录的代码文件的引用，即代码文件分布在不同目录时，怎样使用。
例如，有2个方法组织代码目录，方法1是每个目录下都有自己的mod文件即mod.rs，方法2是每个目录的同层级都有对应同名的rs文件。

[tianshimoyi]

use 和 pub use 到底什么区别啊？求大佬指教

[lijing-2008]

use在当前作用域有用，只是一个简写，加上了pub就会对外暴露出去，当前模块的父模块之类可以使用

[xpader]

是的，目录间的模块这么重要的部分居然没讲。

[zhangdekui]

在 Rust 语言中，mod.rs 文件是一种特殊的文件名，它通常用于实现模块（module）的组织和管理。

具体来说，当我们在 Rust 语言中创建一个模块时，通常会在模块所在的目录下创建一个名为 mod.rs 的文件。这个 mod.rs 文件中通常包含了该模块的所有公共 API 的定义。

举个例子，假设我们有一个名为 my_module 的模块，它的目录结构如下：

my_module/
├── mod.rs
├── foo.rs
└── bar.rs

其中，mod.rs 文件用于定义 my_module 模块的公共 API，而 foo.rs 和 bar.rs 文件则用于实现这些 API。

在 mod.rs 文件中，通常会使用 pub use 语法来导出该模块中的公共 API，例如：

pub use foo::my_function1;
pub use bar::my_function2;

在这个示例中，我们使用 pub use 语法将 foo 模块中的 my_function1() 函数和 bar 模块中的 my_function2() 函数导出为 my_module 模块的公共 API。

总之，mod.rs 文件是 Rust 语言中非常常用的一个文件，它可以帮助我们组织和管理模块，并实现代码的可重用性和可读性。

[zhangdekui]

from chatgpt:

[yoyoLooming]

怎么在我的项目里用这个restaurant呢..

[licq]

不知道后边有没有分享真实项目package, crate, module的使用的，因为这里不仅是规则上的问题，更多的是一种最佳实践。

[sunface]

practice.rs 上有更详细的练习

[sunfu12]

讲得非常清楚，看懂了，太棒了

[Roxannej]

还是要用起来才知道

[Roxannej]

这个文件夹的问题还是要实践

[xiandaoyan]

引入项再导出---的pub use没看懂，在另一个文件中引入mod之后pub use照样不能访问其中的非pub模块都嘛？请高手赐教

[mattwhatsup]

pub(self)只在当前模块可见有什么意义呢？模块内部的同级本来私有的也是可见的，这是私有的默认定义吗？

[mgisr]

Stack Overflow上有关于这个问题的解释。How is pub(self) visibility different from no pub attribute?

[arielherself]

TL;DR 就是跟没有一样

[Endermanbugzjfc]

https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md#semantics 似乎是在宏的时候有些许用处

[Icemans007]

我感觉，pub, pub(crate), pub(super), 没有pub, pub(self), pub(in <path>) 这些限定的可见性都是针对此模块的外层模块？此模块子孙模块照样可以访问

[yxxuweb]

我没看明白受限的可见性那块的描述。代码上给点注释啊。

[Risuntsy]

lib.rs

// lib.rs
pub mod a {
}

main.rs

// main.rs
// 
use test::a;

fn main() {}
 

Cargo.toml

[package]
name = "test"
version = "0.1.0"
edition = "2021"

这样写可以通过cargo编译，但是VS Code报错提示:

error[E0425]: cannot find function `test_main_static` in crate `test`

我有些疑惑默认lib.rs和main.rs中模块的关系

[Risuntsy]

cargo test输出如下

Compiling test v0.1.0 (../Test)
	error[E0425]: cannot find function `test_main_static` in crate `test`

warning: unused import: `test::a`
 --> src\main.rs:1:5
  |
1 | use test::a;
  |     ^^^^^^^
  |
  = note: `#[warn(unused_imports)]` on by default

For more information about this error, try `rustc --explain E0425`.
warning: `test` (bin "test" test) generated 1 warning
error: could not compile `test` (bin "test" test) due to previous error; 1 warning emitted

[Risuntsy]

草，好像是项目名称为test时有某种冲突，其他名称就不会有问题了

[rucat125]

https://www.cnblogs.com/fire-cat/p/17578600.html
这是我自己总结的关于分文件规划模块的随笔，大家帮忙看看有没有什么不对和遗漏的。
水平有限，多多包涵😊

[jareguo]

总结：

• 每个目录都是一个模块，要在目录旁边定义一个同名 rs 文件，或者包含一个 mod.rs，作用类似于 index.js
• [mod.rs](http://mod.rs) 和同名 rs 文件为空的话将创建空模块，如果要引入目录中的其它文件就需要在此文件中声明
• 每个 rs 文件都是一个模块，但只有被其它模块引入时才会被编译
• mod xxx; 或 pub mod xxx; 才是真正加载模块的语句。后者将同时导出子模块。
• pub use 用来导出已加载的模块中的任意 pub 项，pub use [xxx::]yyy as zzz; 会以 zzz 的名字重新导出 yyy。
• 光秃秃的 use 只是语法糖。

[Risuntsy]

use是什么语法糖??
pub mod是导出时暴露模块到当前命名空间，供外部访问，如果一个pub mod内都是private那样对其他模块来说也没什么意义

[jareguo]

use是什么语法糖??

我说的是光秃秃的 use，相对 pub use 而言的。就是你在行首写一行 use std::xxx，跟在下面 xxx.yyy 的每个地方都写上 std::xxx.yyy 不是一样吗？

pub mod是导出时暴露模块到当前命名空间，供外部访问，如果一个pub mod内都是private那样对其他模块来说也没什么意义

没错，只是我用我的语言总结了一下，作为官方标准定义的补充吧。意思跟你说的没区别。

[Icemans007]

感到有点意外是，例子中使用第三方的 rand package，在模块内使用却没有类似 use rand，和其他编程语言有不同，其他语言类似导入作用域意思，但这个 use 它没有半点导入意思，感觉更像是在此模块内命名申明

[sanrentai]

绕迷糊了

[upWooStream]

pub(self) 在当前模块可见的意义何在？如果只是当前模块可见，直接不使用pub就可以了吗？

[Endermanbugzjfc]

https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md#semantics 似乎是在宏的时候有些许用处

[Quaternijkon]

有点不太优雅

[Skyfacon]

打卡

[vince-1998]

2.12 竟然是我看的最懵逼的一章，莫非是我心态轻浮了。。。

[yuzheng14]

受限的可见性这里举的例子不太合适

// 目标：`a` 导出 `I`、`bar` and `foo`，其他的不导出
pub mod a {
    pub const I: i32 = 3;

    fn semisecret(x: i32) -> i32 {
        use self::b::c::J;
        x + J
    }

    pub fn bar(z: i32) -> i32 {
        semisecret(I) * z
    }
    pub fn foo(y: i32) -> i32 {
        semisecret(I) + y
    }

    mod b {
        mod c {
            const J: i32 = 4;
        }
    }
}

这里本身函数 semisecret 和模块 b 在同一个模块下，semisecret 是可以访问到模块 b 的，所以只需要给模块 c 和常量 J 标记为 pub 即可，与 pub(in crate::a) 的实际作用一样。完整代码如下：

// 目标：`a` 导出 `I`、`bar` and `foo`，其他的不导出
pub mod a {
    pub const I: i32 = 3;

    fn semisecret(x: i32) -> i32 {
        use self::b::c::J;
        x + J
    }

    pub fn bar(z: i32) -> i32 {
        semisecret(I) * z
    }
    pub fn foo(y: i32) -> i32 {
        semisecret(I) + y
    }

    mod b {
        pub mod c {
            pub const J: i32 = 4;
        }
    }
}

[zhoulian1193]

怎么用lib.rs查找包啊，没看懂

[jokiclll]

模块mod这块不太复杂，但可见性这块挺复杂的，结合实战继续学习吧！

[PigsyAK]

二刷，觉得更加牛逼了

[PigsyAK]

常读常新