Skip to content

Latest commit

 

History

History
executable file
·
38 lines (28 loc) · 2.41 KB

a2.installation.md

File metadata and controls

executable file
·
38 lines (28 loc) · 2.41 KB

title: Installation

Rustup

There are many ways to install Rust on your system. For the moment the official way to install Rust is using Rustup.

📖 Rustup installs The Rust Programming Language from the official release channels, enabling you to easily switch between stable, beta, and nightly compilers and keep them updated. It makes cross-compiling simpler with binary builds of the standard library for common platforms.

📖 Rustup installs rustc, cargo, rustup and other standard tools to Cargo's bin directory. On Unix it is located at $HOME/.cargo/bin and on Windows at %USERPROFILE%\.cargo\bin. This is the same directory that cargo install will install Rust programs and Cargo plugins.

🔎 The main tools Rustup installs to the Cargo's bin directory,

  • rustc: The Rust compiler.
  • cargo: The Rust’s built-in package manager and the build system.
  • rustup: The Rust toolchain installer.
  • rustfmt: The Rust’s official tool of formatting Rust code according to style guidelines.
  • cargo-fmt: Helps to run rustfmt on whole Rust projects, including multi-crate workspaces.
  • cargo-clippy: A lint tool that provides extra checks for common mistakes and stylistic choices.
  • cargo-miri:An experimental Rust interpreter, which can be used for checking for undefined-behavior.
  • rls: A language server that provides support for editors and IDEs.
  • rustdoc: A local copy of the Rust documentation.

Installation

For Mac and Linux Users

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

For Windows Users

Download rustup-init.exe from www.rustup.rs and run.

⭐ If you are on Microsoft Windows, you have to install Visual C++ Build Tools 2015 or higher, which requires an additional 3–4 GBs.

Before going to the next...

  • To verify the current Rust version, use the rustc --version or rustc -V command.
  • Rust ships releases on six week cycles. When a new Rust version released, use the rustup update command to update the Rust ecosystem.
  • To open the offline Rust documentation, use the rustup doc command. For more rustup commands, check the rustup --help command.