编译器参数属性和编译器参数 -Rust 中文教程集册

本章将介绍Rust编译器的参数。

Rust编译器程序的名字是rustc，使用它的方法很简单：

$ rustc [OPTIONS] INPUT

其中，[OPTIONS]表示编译参数，而INPUT则表示输入文件。而编译参数有以下可选：

-h, --help - 输出帮助信息到标准输出；
--cfg SPEC - 传入自定义的条件编译参数，使用方法如
```
fn main() {
    if cfg!(hello) {
        println!("world!");
    }
}
```
如上例所示，若cfg!(hello)成立，则运行程序就会输出"world"到标准输出。我们把这个文件保存为hello.rs然后编译它
```
$ rustc --cfg hello hello.rs
```
运行它就会看到屏幕中输出了world!。
-L [KIND=]PATH - 往链接路径中加入一个文件夹，并且可以指定这个路径的类型（Kind），这些类型包括
- dependency - 在这个路径下找依赖的文件，比如说mod；
- crate - 只在这个路径下找extern crate中定义的库；
- native - 只在这个路径下找Native库；
- framework - 只在OS X下有用，只在这个路径下找Framework；
- all - 默认选项。
-l [KIND=]NAME - 链接一个库，这个库可以指定类型（Kind）
- static - 静态库；
- dylib - 动态库；
- framework - OS X的Framework。
如果不传，默认为dylib。

此处举一个例子如何手动链接一个库，我们先创建一个文件叫myhello.rs，在里面写一个函数
```
// myhello.rs

/// 这个函数仅仅向标签输出打印 Hello World!
/// 不要忘记要把它标记为 pub 哦。
pub fn print_hello() {
    println!("Hello World!");
}
```
然后把这个文件编译成一个静态库，libmyhello.a
```
$ rustc --crate-type staticlib myhello.rs
```
然后再创建一个main.rs，链接这个库并打印出"Hello World!"
```
// main.rs

// 指定链接库 myhello
extern crate myhello;

fn main() {
    // 调用库函数
    myhello::print_hello();
}
```
编译main.rs
```
$ rustc -L. -lmyhello main.rs
```
运行main，就会看到屏幕输出"Hello World!"啦。
--crate-type - 指定编译输出类型，它的参数包括
- bin - 二进行可执行文件
- lib - 编译为库
- rlib - Rust库
- dylib - 动态链接库
- staticlib - 静态链接库
--crate-name - 指定这个Crate的名字，默认是文件名，如main.rs编译成可执行文件时默认是main，但你可以指定它为foo
```
$ rustc --crate-name foo main.rs
```
则会输出foo可执行文件。
--emit - 指定编译器的输出。编译器默认是输出一个可执行文件或库文件，但你可以选择输出一些其它的东西用于Debug
- asm - 输出汇编
- llvm-bc - LLVM Bitcode；
- llvm-ir - LLVM IR，即LLVM中间码（LLVM Intermediate Representation）；
- obj - Object File（就是*.o文件）；
- link - 这个是要结合其它--emit参数使用，会执行Linker再输出结果；
- dep-info - 文件依赖关系（Debug用，类似于Makefile一样的依赖）。
以上参数可以同时使用，使用逗号分割，如
```
$ rustc --emit asm,llvm-ir,obj main.rs
```
同时，在最后可以加一个=PATH来指定输出到一个特定文件，如
```
$ rustc --emit asm=output.S,llvm-ir=output.ir main.rs
```
这样会把汇编生成到output.S文件中，把LLVM中间码输出到output.ir中。
--print - 打印一些信息，参数有
- crate-name - 编译目标名；
- file-names - 编译的文件名；
- sysroot - 打印Rust工具链的根目录地址。
-g - 在目标文件中保存符号，这个参数等同于-C debuginfo=2。
-O - 开启优化，这个参数等同于-C opt-level=2。
-o FILENAME - 指定输出文件名，同样适用于--emit的输出。
--out-dir DIR - 指定输出的文件夹，默认是当前文件夹，且会忽略-o配置。

--explain OPT - 解释某一个编译错误，比如

若你写了一个main.rs，使用了一个未定义变量f

fn main() {
    f
}

编译它时编译器会报错：

main.rs:2:5: 2:6 error: unresolved name `f` [E0425]
main.rs:2     f
              ^
main.rs:2:5: 2:6 help: run `rustc --explain E0425` to see a detailed explanation
error: aborting due to previous error

虽然错误已经很明显，但是你也可以让编译器解释一下，什么是E0425错误：

$ rustc --explain E0425
// 编译器打印的说明

--test - 编译成一个单元测试可执行文件
--target TRIPLE - 指定目标平台，基本格式是cpu-manufacturer-kernel[-os]，例如
```
## 64位OS X
$ rustc --target x86_64-apple-darwin
```
-W help - 打印Linter的所有可配置选项和默认值。
-W OPT, --warn OPT - 设置某一个Linter选项为Warning。
-A OPT, --allow OPT - 设置某一个Linter选项为Allow。
-D OPT, --deny OPT - 设置某一个Linter选项为Deny。
-F OPT, --forbit OPT - 设置某一个Linter选项为Forbit。
-C FLAG[=VAL], --codegen FLAG[=VAL] - 目标代码生成的的相关参数，可以用-C help来查看配置，值得关注的几个是
- linker=val - 指定链接器；
- linker-args=val - 指定链接器的参数；
- prefer-dynamic - 默认Rust编译是静态链接，选择这个配置将改为动态链接；
- debug-info=level - Debug信息级数，0 = 不生成，1 = 只生成文件行号表，2 = 全部生成；
- opt-level=val - 优化级数，可选0-3；
- debug_assertion - 显式开启cfg(debug_assertion)条件。
-V, --version - 打印编译器版本号。
-v, --verbose - 开启啰嗦模式（打印编译器执行的日志）。
--extern NAME=PATH - 用来指定外部的Rust库（*.rlib）名字和路径，名字应该与extern crate中指定的一样。
--sysroot PATH - 指定工具链根目录。
-Z flag - 编译器Debug用的参数，可以用-Z help来查看可用参数。
--color auto|always|never - 输出时对日志加颜色
- auto - 自动选择加还是不加，如果输出目标是虚拟终端（TTY）的话就加，否则就不加；
- always - 给我加！
- never - 你敢加？

编译器参数

在这篇文章中：

目录