Installer Rust avec `rustup` (Windows, macOS, Linux)

`rustup` : la clé de voûte de votre installation Rust

L'installation de Rust est grandement simplifiée grâce à un outil en ligne de commande appelé `rustup`. C'est la méthode officielle et recommandée pour installer et gérer vos environnements de développement Rust. `rustup` n'installe pas seulement le compilateur Rust (`rustc`) et son gestionnaire de paquets (`cargo`), mais il vous permet également de gérer différentes versions de Rust (appelées toolchains), de les mettre à jour facilement, et d'installer des composants supplémentaires comme la documentation locale ou des outils d'analyse statique.

Utiliser `rustup` garantit que vous disposez d'une installation propre et standardisée, quel que soit votre système d'exploitation. Il facilite le passage entre la version stable, bêta ou nightly de Rust, ce qui peut être utile pour tester de nouvelles fonctionnalités ou contribuer au développement du langage. De plus, `rustup` configure correctement votre variable d'environnement `PATH` pour que les outils Rust soient accessibles depuis n'importe quel terminal.

Ce guide vous montrera comment utiliser `rustup` pour installer Rust sur les systèmes d'exploitation les plus courants : Windows, macOS et Linux. Bien que la commande initiale puisse légèrement différer, le principe reste le même : télécharger `rustup` et le laisser gérer l'installation de la toolchain stable par défaut.

Installation de Rust sur Linux et macOS

Sur les systèmes d'exploitation de type Unix comme Linux et macOS, l'installation de Rust via `rustup` se fait généralement à l'aide d'une simple commande dans votre terminal. Vous aurez besoin d'une connexion internet et de l'outil `curl` (qui est généralement préinstallé sur ces systèmes).

Ouvrez votre application de terminal (Terminal sur macOS, ou l'émulateur de terminal de votre choix sur Linux) et exécutez la commande suivante :

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

Cette commande télécharge un script shell sécurisé (`-sSf` signifie silencieux, montrer les erreurs, échouer en cas d'erreur, et forcer HTTPS avec TLS 1.2) depuis le site officiel de Rust et l'exécute (`| sh`). Le script va alors télécharger et installer `rustup` ainsi que la dernière version stable de la toolchain Rust (compilateur, Cargo, documentation standard).

Pendant l'exécution, le script vous posera quelques questions concernant les options d'installation. Vous verrez quelque chose comme ceci :

Current installation options:

   default host triple: x86_64-unknown-linux-gnu (ou similaire pour macOS)
     default toolchain: stable
               profile: default
  modify PATH variable: yes

1) Proceed with installation (default)
2) Customize installation
3) Cancel installation

Pour la plupart des utilisateurs, l'option 1 (Proceed with installation (default)) est la meilleure. Elle installera la version stable de Rust et configurera votre `PATH` automatiquement. Si vous souhaitez personnaliser l'installation (par exemple, choisir une toolchain spécifique ou ne pas modifier le `PATH`), vous pouvez choisir l'option 2.

Une fois l'installation terminée, `rustup` vous indiquera que le répertoire `~/.cargo/bin` (où sont installés les outils Rust) a été ajouté à votre `PATH`. Pour que cette modification prenne effet dans votre session de terminal actuelle, vous devrez généralement exécuter la commande qu'il vous suggère, qui est souvent :

source "$HOME/.cargo/env"

Ou, plus simplement, vous pouvez fermer et rouvrir votre terminal. Pour vérifier que tout fonctionne, tapez `rustc --version`. Vous devriez voir la version du compilateur Rust s'afficher.

Installation de Rust sur Windows

Sur Windows, l'installation de Rust avec `rustup` est également très simple. La principale différence réside dans le fait que Rust nécessite un lieur (linker) compatible C, et sur Windows, cela signifie généralement que vous avez besoin des outils de build C++ de Microsoft Visual Studio (MSVC).

La première étape est de télécharger l'installateur `rustup-init.exe` depuis la page d'installation officielle de Rust : https://www.rust-lang.org/tools/install. Cliquez sur le bouton de téléchargement pour Windows (64-bit ou 32-bit selon votre système).

Exécutez `rustup-init.exe` une fois téléchargé. Une fenêtre de console s'ouvrira et vous présentera des options similaires à celles vues sur Linux/macOS :

Current installation options:

   default host triple: x86_64-pc-windows-msvc (ou i686-pc-windows-msvc pour 32-bit)
     default toolchain: stable
               profile: default
  modify PATH variable: yes

1) Proceed with installation (default)
2) Customize installation
3) Cancel installation

Ici aussi, l'option 1 (Proceed with installation (default)) est généralement recommandée. Si les outils de build MSVC ne sont pas détectés sur votre système, `rustup-init.exe` vous proposera de les installer. Il est fortement conseillé d'accepter cette proposition, car ils sont nécessaires pour compiler la plupart des projets Rust sur Windows. L'installation des outils MSVC peut prendre un certain temps et nécessiter des droits d'administrateur. Si vous préférez utiliser la toolchain GNU (qui utilise MinGW-w64), vous pouvez choisir l'option de personnalisation (2) et sélectionner une toolchain `*-pc-windows-gnu` ; cela nécessitera que vous ayez déjà une installation MinGW fonctionnelle.

Une fois l'installation de Rust et de ses dépendances terminée, `rustup` aura configuré votre variable d'environnement `PATH` pour inclure `%USERPROFILE%\.cargo\bin`. Il est généralement nécessaire de redémarrer toutes les instances de terminal ouvertes, voire de redémarrer votre session Windows ou votre ordinateur, pour que les modifications du `PATH` soient prises en compte partout. Pour vérifier l'installation, ouvrez une nouvelle invite de commandes (cmd.exe) ou PowerShell et tapez `rustc --version`.

Vérification et gestion de votre installation Rust

Que vous soyez sur Windows, macOS ou Linux, après avoir suivi les étapes d'installation et configuré votre PATH (ou redémarré votre terminal/session), vous pouvez vérifier que Rust est correctement installé. Ouvrez un nouveau terminal et tapez les commandes suivantes :

rustc --version

Cela devrait afficher la version du compilateur Rust, par exemple : `rustc 1.70.0 (90c541806 2023-05-31)`.

cargo --version

Cela devrait afficher la version de Cargo, par exemple : `cargo 1.70.0 (ec8a8a0ca 2023-04-25)`.

L'un des grands avantages de `rustup` est la facilité de mise à jour. Pour mettre à jour votre toolchain Rust (ainsi que `rustup` lui-même) vers la dernière version stable, il suffit d'exécuter :

rustup update

Il est bon de lancer cette commande de temps en temps pour bénéficier des dernières améliorations et corrections du langage et des outils.

Vous pouvez voir quelles toolchains sont installées et laquelle est active avec :

rustup show

Vous pouvez également installer des composants supplémentaires pour votre toolchain active. Par exemple, pour ajouter `clippy` (un linter très utile pour Rust) et `rustfmt` (un formateur de code automatique), vous utiliseriez :

rustup component add clippy
rustup component add rustfmt

Enfin, pour accéder à la documentation officielle de Rust qui a été installée localement, vous pouvez taper :

rustup doc

Cela ouvrira la documentation dans votre navigateur web par défaut. Avoir la documentation hors ligne est extrêmement pratique. Avec `rustup`, votre environnement de développement Rust est désormais prêt et facile à maintenir !