Racer - Rust代码补全

RACER = Rust Auto-Complete-er。一个旨在为编辑器和IDE提供Rust代码补全的实用工具。也许有一天，"er"部分将会探索重构或其他功能。

免责声明

Racer目前没有积极开发。请考虑使用更新的软件，如rust-analyzer。

安装

注意 从2.1版本开始，racer需要nightly rust

要求

当前nightly Rust

如果你使用rustup，请运行

rustup toolchain install nightly
rustup component add rustc-dev --toolchain=nightly

注意：第二个命令将rustc-dev组件添加到nightly工具链中，这是编译Racer所必需的。

Cargo

内部，racer将cargo作为CLI工具调用，所以请确保cargo已经安装

使用cargo install

只需运行

cargo+nightly install racer

如命令输出中所述，不要忘记将安装目录添加到你的PATH。

从源代码

1. 克隆仓库：git clone https://github.com/racer-rust/racer.git

2. cd racer; cargo +nightly build --release。二进制文件现在位于./target/release/racer

3. 将二进制文件添加到你的PATH。这可以通过将其移动到已存在于PATH中的目录（例如/usr/local/bin）或通过将./target/release/目录添加到你的PATH中来实现

配置

1. 获取Rust源代码

   1. 通过 rustup 自动安装，并运行 rustup component add rust-src 以将源代码安装到 $(rustc --print sysroot)/lib/rustlib/src/rust/library（或在旧工具链中使用$(rustc --print sysroot)/lib/rustlib/src/rust/src）。如果你运行 rustup update，Rustup 将保持源代码与工具链同步。

   2. 手动从 git: https://github.com/rust-lang/rust

   注意

   如果你想使用 racer 与多个发布渠道（Rust 有 3 个发布渠道：stable、beta 和 nightly），你必须为安装的每个发布渠道下载 Rust 源代码。

   例如（rustup 的情况）添加夜间工具链构建并安装夜间源代码

   rustup工具链添加夜间

   rustup组件添加 rust-src

2. （可选）设置环境变量 RUST_SRC_PATH 指向 Rust 源安装中的 'src' 目录，例如 % export RUST_SRC_PATH=$(rustc --print sysroot)/lib/rustlib/src/rust/library 或 % export RUST_SRC_PATH="$(rustc --print sysroot)/lib/rustlib/src/rust/src"（旧版）

   建议设置 RUST_SRC_PATH 以提高速度，但如果你没有设置它，Racer 也会自动检测。

3. 在命令行中测试

   racer complete std::io::B （应显示一些补全项）

注意

要完成外部包中的名称，Racer 需要 Cargo.lock。因此，当你向你的 Cargo.toml 中添加依赖项时，你必须运行构建命令，例如 cargo build 或 cargo test，以获取补全项。

支持的编辑器/IDE

RLS

Racer 在 RLS 中用作静态库

Eclipse 集成

可以通过使用 RustDT 在 Eclipse 中使用 Racer。（用户指南链接在存储库描述中）

Emacs 集成

Emacs 集成已移动到单独的项目： emacs-racer。

Gedit 集成

可以在 这里 找到 Gedit 集成。

构建器集成

GNOME Builder 集成可以在这里找到

Kate 集成

Kate 社区维护了一个插件。它包含在 Kate 的最新版本中（已与 16.08 版本进行测试 - 更多信息请参阅这里）。

1. 在 Kate 配置对话框的插件列表中启用 'Rust 代码补全'；

2. 在新 'Rust 代码补全' 对话页面中，确保 'Racer 命令' 和 'Rust 源树位置' 设置正确。

Sublime Text 集成

Sublime Text 社区维护了一些集成 Racer 的软件包

• RustAutoComplete 提供自动完成和跳转到定义功能。
• AnacondaRUST 是来自 anaconda 插件系列的，提供自动完成、跳转到定义和显示文档功能。

Vim 集成

Vim 集成已被移至单独的项目：vim-racer。

Visual Studio Code 扩展

Racer 推荐基于 RLS 且使用 Racer 进行补全的官方 Rust (rls) 扩展。

Atom 集成

您可以在这里找到 Atom 的 racer 包

Kakoune 集成

Kakoune 集成了 racer 自动补全功能。