crate 与源文件
Syntax
Crate →
InnerAttribute*
Item*
Note
虽然 Rust 和任何其他语言一样，既可以通过解释器也可以通过编译器来实现，但目前唯一的实现是编译器，而且这门语言始终被设计为编译型。基于这些原因，本节假定使用编译器。
Rust 的语义遵循编译时和运行时之间的阶段区分。1具有静态解释的语义规则决定编译成功或失败，而具有动态解释的语义规则决定程序在运行时的行为。
编译模型以称为 crate 的工件为中心。每次编译处理一个源代码形式的 crate，如果成功，则生成一个二进制形式的 crate：要么是可执行文件，要么是某种库。2
crate 是编译和链接的单元，也是版本控制、分发和运行时加载的单元。一个 crate 包含一个由嵌套的模块作用域组成的树。这棵树的顶层是一个匿名模块（从该模块内的路径角度来看），crate 中的任何项都有一个规范模块路径来表示它在 crate 的模块树中的位置。
Rust 编译器总是以单个源文件作为输入进行调用，并且总是产生单个输出 crate。对该源文件的处理可能导致其他源文件作为模块被加载。源文件的扩展名是 .rs。
Rust 源文件描述一个模块，该模块在当前 crate 的模块树中的名称和位置是由源文件外部定义的：要么是通过引用源文件中的显式 Module 项，要么是通过 crate 本身的名称。
每个源文件都是一个模块，但并非每个模块都需要自己的源文件：模块定义可以在一个文件内嵌套。
每个源文件包含零个或多个项定义，并且可以选择以任意数量的属性开头，这些属性适用于包含该文件的模块，其中大多数影响编译器的行为。
匿名 crate 模块可以有额外的属性，这些属性适用于整个 crate。
Note
文件内容可以以 shebang 开头。
#![allow(unused)]
fn main() {
// 指定 crate 名称。
#![crate_name = "projx"]
// 指定输出工件的类型。
#![crate_type = "lib"]
// 开启一个警告。
// 这可以在任何模块中完成，不仅仅是匿名 crate 模块。
#![warn(non_camel_case_types)]
}main 函数
包含 main 函数的 crate 可以被编译为可执行文件。
如果存在 main 函数，它必须不接受任何参数，不能声明任何 trait 约束或生命周期约束，不能有任何 where 子句，并且其返回类型必须实现 Termination trait。
fn main() {}fn main() -> ! {
std::process::exit(0);
}fn main() -> impl std::process::Termination {
std::process::ExitCode::SUCCESS
}main 函数可以是一个导入，例如来自外部 crate 或当前 crate。
#![allow(unused)]
fn main() {
mod foo {
pub fn bar() {
println!("Hello, world!");
}
}
use foo::bar as main;
}Note
标准库中实现了
Termination的类型包括：
()!InfallibleExitCodeResult<T, E> where T: Termination, E: Debug
未捕获的外部展开
当“外部“展开（例如 C++ 代码抛出的异常，或使用不同 panic 处理器的 Rust 代码中的 panic!）传播到 main 函数之外时，进程将被安全终止。这可能表现为中止，在这种情况下，不能保证任何 Drop 调用会被执行，并且错误输出可能比由“原生“ Rust panic 终止运行时更少。
更多信息请参阅 panic 文档。
no_main 属性
no_main 属性 可以用在 crate 级别，以禁止为可执行二进制文件生成 main 符号。这在链接的其他对象定义了 main 时很有用。
crate_name 属性
crate_name 属性 可以用在 crate 级别，以通过 MetaNameValueStr 语法指定 crate 的名称。
#![allow(unused)]
#![crate_name = "mycrate"]
fn main() {
}crate 名称不能为空，且只能包含 Unicode 字母数字字符或 _（U+005F）字符。