从高级程序员的角度来看 rust编程入门实战与进阶( 七 ) _进阶

讨论完命名空间之后，我们来讨论一下可见性。
本质上，默认情况下任何东西都是私有的，只能被它所在的文件访问。
● trait及其方法
● 结构及其成员
● enum（成员继承enum的可见性，这是合理的，参见Match）
● 函数
● trait的实现依赖于trait和实现该trait的结构，即，只有两者都是公有的，该实现才是公有的。
要设置为公有（即可以从外部访问），需要使用关键字pub：
pub struct Something { pub letter: char}pub trait CustomTrait { ... }pub fn method {}

文章插图
使用多个文件
有时候我会想念 require("./fire") 。
要想“导入”一个文件，要使用 mod指令。通过cargo下载的crate会自动导入。
main.rs
mod my;fn main { my::function; // or use my::function; function;}
my.rs
pub fn function { println!("function");}
你也可以使用pub mob重新导出一个文件。绝大多数已有的Rust代码都会对支持文件夹采用下列操作：
main.rs
mod my;use my::file;fn main { file::function;}
my/mod.rs - mod.rs这个名字是特殊的，类似于index.js
pub mod file;
my/file.rs
pub fn function { println!("function");}
关于println!，参见“打印输出” 。

文章插图
编写文档
编写文档只需使用三个斜线 /// 。一些IDE会采用不同的高亮方式显示。
类似于JSDoc，只不过其类型不会显式标注，因为代码中已经写了类型。
/// a description of varlet var = "something";
原文地址：https://danbulant.eu/posts/rust-basics