AnacondaRUST

AnacondaRust提供Rust语言的自动完成、自动格式化和检查功能，不会冻结您的Sublime Text 3

支持的平台

AnacondaRUST在GNU/Linux、OS X和Windows 10上进行了测试，取得了优秀的结果。请注意，这个插件目前处于非常早期状态，可能存在一些需要修复的bug和需要改进的地方。不同平台的状态如下：

依赖

1. Anaconda插件用于Sublime Text 3
2. Rust编译器（rustc）和cargo
3. Racer代码自动完成
4. rustfmt >= 0.5.0代码格式化器
5. Rust标准库源代码

安装

如果Anaconda尚未安装，您必须使用命令面板进行安装，如果已安装，请跳到安装rustc部分。

安装Anaconda

1. 显示命令面板（在OS X上为Cmd + Shift + P，在Linux/Windows上为Ctrl + Shift + P）
2. 键入install，然后从选项列表中选中Package Control: Install package
3. 键入anaconda并按Enter键

安装Rust

如果您已在系统上安装了rustc和cargo，请跳到安装Racer部分。

安装Rust在不同的操作系统上有多种方式，下面只是概述，请根据您的操作系统参考Rust语言网站了解更多安装信息。

GNU/Linux和OS X

我们可以在GNU/Linux和OS X上简单地通过在终端中复制并粘贴以下命令来安装Rust：

curl -sSf https://static.rust-lang.org/rustup.sh | sh

上述命令将下载并安装最新稳定的Rust版本到您的/usr/local/目录（您可能需要root权限才能这样做）。

注意：所有主要的GNU/Linux发行版都在其包管理器系统中提供预编译的二进制Rust，如果您愿意，您可以使用您的发行版包管理器来安装它，您选择的方法应该是没有问题的。

Windows 10（其他版本可能也是可以的）

在Windows上安装Rust最简单的方法是下载Windows二进制安装程序(.msi)，从https://www.rust-lang.net.cn/downloads.html，请注意，有两种不同的C/C++应用程序二进制接口(ABI)，一种用于GNU，另一种用于MSVC，选择哪一个是一个非常重要的决定，因为它将决定您是否可以编译与系统中的C或C++库绑定的Rust代码（例如rust-crypto）。

重要的是要理解，为了编译包含一些C绑定的Rust包，您需要安装一个生成与Rust编译器ABI兼容的二进制文件的编译器。这意味着安装MinGW/MSYS2工具链或Microsoft Visual C++ Build Tools（或者选择Visual Studio并选择安装过程中的C++工具）。

如何选择我的ABI？

很简单，如果您在Windows上使用MinGW/MSYS2工具链编译C和C++代码，只需要下载安装程序的GNU ABI版本，否则，您应该下载MSVC版本，因为很可能您Windows中的所有应用程序和库都是使用某个版本的Microsoft Visual C++编译器编译的。

安装Racer

如果系统已经安装了Racer，请跳转到安装rustfmt部分。Racer可以通过cargo轻松安装，如下所示：

cargo install racer

这将下载所有源代码，编译并将racer安装到您的cargo二进制目录中，cargo真是太棒了。

安装rustfmt

如果系统中已经安装了rustfmt，请跳转到安装AnacondaRUST部分。rustfmt可以通过cargo轻松安装，如下所示：

cargo install rustfmt

上述命令将下载、编译并在系统中安装rustfmt，再次强调，cargo真是太棒了。

注意：为了实现顺利进行集成，安装rustfmt 0.5.0或更高版本，较旧版本在用于anaconda_rust时可能存在问题。

安装AnacondaRUST

要安装AnacondaRUST，您只需要按照以下步骤操作：

1. 显示命令面板（在OS X上为Cmd + Shift + P，在Linux/Windows上为Ctrl + Shift + P）
2. 输入install，然后从选项列表中选择Package Control: Install package。
3. 输入anaconda_rust并按Enter。

配置AnacondaRUST

Anaconda如果在您的PATH中包含rustc、racer和rustfmt，可以“开箱即用”，您已经下载了Rust源代码，并且环境变量RUST_SRC_PATH设置为Rust源代码下载到的路径。这是一个完美的场景，但可能不会发生，因此请仔细阅读以下步骤以确保AnacondaRUST正常运行。

下载Rust源代码

您可能会 wonder，为什么我已经在上一节中 安装了 rust，我还想让您下载 Rust 源代码，原因很简单，racer 需要访问 Rust 的源代码才能提供 rust 标准库的自动完成功能。Rust 源代码可以从其网站 https://www.rust-lang.net.cn/downloads.html 下载，只需下载与您系统上已安装的相同版本的源代码。

配置二进制路径

使用 Preferences -> Package Settings -> AnacondaRUST 打开 AnacondaRUST 配置并设置您的 racer 和 rustfmt 二进制文件的路径。例如

{
    "rustc_binary_path": "/usr/bin/rustc",
    "racer_binary_path": "/home/damnwidget/.cargo/bin/racer",
    "rustfmt_binary_path": "/home/damnwidget/.cargo/bin/rustfmt"
}

配置 Rust 源代码路径

现在您需要告诉 AnacondaRUST 您的 Rust 源代码副本在系统中的位置，就像这样添加到您的 AnacondaRUST 配置中：

...
    "rust_src_path": "/home/damnwidget/downloads/languages/rust/sources/1.8.0/src",

设置 RUST_SRC_PATH 环境变量并保留 rust_src_path 配置为空可能在将环境变量传递给 Sublime Text 3 可执行文件的操作系统中工作，但不幸的是这并不总是奏效，所以我真的建议将您的 AnacondaRUST 设置设置为避免未来的问题。

Linter 选项

AnacondaRUST（显然）包括一个用于 Rust 代码的 linter，linter 通常以异步方式运行，每次您保存文件时都会运行。

禁用 linter

AnacondaRUST linter 默认启用，可以通过将配置中的 anaconda_rust_linting 设置为 false 来完全禁用它。

转到定义

AnacondaRUST 包含一个转到定义功能，但默认情况下不会添加键盘快捷方式。您可以通过 Command Palette 访问 Goto Rust Definition 功能，如果您想为它添加键盘快捷方式，可以使用类似以下内容

{
    "command": "rust_goto", "keys": ["ctrl+r", "ctrl+g"], "context": [
        {"key": "selector", "operator": "equal", "operand": "source.rust"}
    ]
}

显示文档

如果已安装 racer 1.2.10 或更高版本，anacondaRUST 可以通过 Control Palette 或 Contextual Menu 提供文档，您还可以添加类似以下内容的快捷方式

{
    "command": "rust_doc", "keys": ["ctrl+r", "ctrl+d"], "context": [
        {"key": "selector", "operator": "equal", "operand": "source.rust"}
    ]
}

许可证

像我的所有 Sublime Text 插件一样，此软件在 GPLv3 条款下许可。

捐赠

请捐款以帮助保持此项目的活力。