Rust程序设计语言

这里是Rust程序设计语言的源码仓库，包括编译器、标准库和文档。

快速上手

从源码构建

确保你安装了如下所需软件：
- g++ 4.7或更高版本，或者clang++ 3.x
- python 2.7（不支持3.x版本）
- GNU make 3.81或更高版本
- cmake 3.4.3或更高版本
- curl
- git

用git从GitHub克隆源码：

$ git clone https://github.com/rust-lang/rust.git
$ cd rust

构建并安装：
```
$ ./x.py build && sudo ./x.py dist --install
```
注意： 可以修改配置文件调整安装目录。将./src/bootstrap/config.toml.example复制到./config.toml，然后修改[install]下的prefix选项指定安装前缀。配置文件里还有很多选项可以配置，请参考配置文件中内置的说明。

sudo ./x.py dist --install运行完成后，会在/usr/local/bin里添加几个程序：
- rustc：Rust编译器
- rustdoc：API文档的生成工具
不过，这个命令不会给你安装Rust的包管理器Cargo，你需要单独构建它。

在Windows上构建

Windows平台上有两种主要的ABI：Visual Studio使用的MSVC原生ABI，以及GCC工具链使用的GNU ABI。选择哪种版本的Rust取决于你依赖于哪些C/C++库：如果你主要同Visual Studio生成的软件交互，那么请选择MSVC构建的Rust；如果你主要同MinGW/MSYS2生成的GNU软件交互，那么请使用GNU工具链构建的Rust。

MinGW

可以用MSYS2轻松地在Windows上构建Rust：

从这里下载最新的安装程序并安装。
从你的MSYS2安装目录（例如，C:\msys64）运行mingw32_shell.bat或mingw64_shell.bat（取决于你要用32位还是64位的Rust）。如果你用的是最新版的MSYS2，可能要运行msys2_shell.cmd -mingw32或msys2_shell.cmd -mingw64。

在终端中安装所需的工具：

# Update package mirrors (may be needed if you have a fresh install of MSYS2)
$ pacman -Sy pacman-mirrors

# Install build tools needed for Rust. If you're building a 32-bit compiler,
# then replace "x86_64" below with "i686". If you've already got git, python,
# or CMake installed and in PATH you can remove them from this list. Note
# that it is important that you do **not** use the 'python2' and 'cmake'
# packages from the 'msys2' subsystem. The build has historically been known
# to fail with these packages.
$ pacman -S git \
            make \
            diffutils \
            tar \
            mingw-w64-x86_64-python2 \
            mingw-w64-x86_64-cmake \
            mingw-w64-x86_64-gcc

进入Rust的源码目录，然后配置并构建：
```
$ ./x.py build && ./x.py dist --install
```

MSVC

MSVC版本的Rust还需要你在系统里安装Visual Studio 2013（或更新版本），rustc需要使用它提供的链接器。请注意在安装时勾选C++ tools选项。

安装完这些依赖关系之后，你就可以在cmd.exe命令行窗口中运行构建命令了：

> python x.py build

目前，你只能使用特定版本的Visual Studio中编译Rust。如果系统中的VS版本太新以至于Rust的构建系统还没有支持的话，你可能需要强制要求rustbuild使用一个旧版本的VS，做法是先调用合适版本的vcvars批处理文件：

CALL "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\bin\amd64\vcvars64.bat"
python x.py build

如何指定一种ABI

只要指明编译三元组，是可以在一种ABI的运行环境中编译生成另一种ABI的目标文件的，例如，你可以在PowerShell中编译出GNU ABI的目标文件。可用的Windows编译三元组包括：

GNU ABI（使用GCC）
- i686-pc-windows-gnu
- x86_64-pc-windows-gnu
MSVC ABI
- i686-pc-windows-msvc
- x86_64-pc-windows-msvc

可以用x.py的--build=ABI选项指定编译三元组，或者也可以如前面介绍过的那样修改config.toml文件中的build选项（在[build]部分）。

`configure`和`make`

尽管不推荐，我们还提供了configure脚本和makefile（其实它只是简单地调用x.py）。

$ ./configure
$ make && sudo make install

如果使用configure脚本，那么生成的config.mk文件会优先于config.toml文件。如果想回头使用config.toml文件，请删除生成的config.mk文件。

如何构建文档

运行如下命令构建文档：

$ ./x.py doc

生成的文档会出现在最上层的doc目录。

备注

由于Rust编译器是使用Rust开发的，所以你需要一个已经编译好的快照版本的Rust编译器才能编译Rust编译器自身。正因如此，你需要联网才能执行构建动作，构建脚本会先去网上下载一个可用的快照版本编译器。

目前我们在如下平台上构建并测试Rust编译器的快照：

平台 / 架构	x86	x86_64
Windows (7, 8, Server 2008 R2)	✓	✓
Linux (2.6.18 or later)	✓	✓
OSX (10.7 Lion or later)	✓	✓

其他的平台可能也会有，但是我们官方支持的平台只有这几个。

现在你需要600MiB到1.5GiB的内存来构建Rust，具体的大小可能随着平台变化。如果用到了交换空间，那需要的时间可就长了。

贡献力量一节中更为详细地介绍了如何hack Rust的建议。

如何获得帮助

Rust社区主要集中在下面几个地方：

Stack Overflow - 直接针对语言用法的问题。
users.rust-lang.org - 一般讨论和相关问题。
/r/rust - 新闻和综合讨论。

如何做出贡献

如果想要为Rust贡献一份力量，请阅读CONTRIBUTING的介绍。

Rust has an IRC culture and most real-time collaboration happens in a variety of channels on Mozilla's IRC network, irc.mozilla.org. The most popular channel is #rust, a venue for general discussion about Rust. And a good place to ask for help would be #rust-beginners.

License

Rust is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0), with portions covered by various BSD-like licenses.

uframer/uframer-rust