Instalar Rust no Arch Linux

Guia para instalar Rust no Arch Linux: rustup vs pacman, AUR helpers, configuração de toolchain e dicas para desenvolvimento produtivo.

O Arch Linux é a distribuição preferida de muitos desenvolvedores por seu modelo rolling release e controle total do sistema. Neste guia, vamos cobrir as diferentes formas de instalar Rust no Arch Linux, com foco no rustup como método recomendado.

Rustup vs Pacman: Qual Escolher?

O Arch Linux oferece pacotes Rust nos repositórios oficiais, mas existem diferenças importantes:

MétodoVantagensDesvantagens
rustupMúltiplas toolchains, atualizações imediatas, cross-compilationInstalação por usuário
pacmanIntegrado ao sistema, gerenciado pelo pacmanUma única versão, sem nightly, sem targets extras

Recomendação: Use rustup para desenvolvimento ativo. Use pacman apenas se precisar do Rust como dependência de compilação de outros pacotes AUR.

Pré-requisitos

Instale as dependências de compilação:

sudo pacman -Syu
sudo pacman -S base-devel curl openssl pkg-config

O grupo base-devel inclui GCC, Make, binutils e outras ferramentas essenciais para compilar crates nativas.

Método 1: Instalar com Rustup (Recomendado)

Via Pacman (wrapper)

O Arch oferece o rustup como pacote:

sudo pacman -S rustup

Depois de instalar o pacote, inicialize a toolchain:

rustup default stable

Via Script Oficial

Alternativamente, use o script oficial:

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

Escolha a opção 1 para instalação padrão.

Configurar o PATH

Se instalou via script oficial, ative no shell:

source "$HOME/.cargo/env"

Se instalou via pacman, o PATH já é configurado automaticamente pelo pacote.

Método 2: Instalar com Pacman (Sistema)

Para instalar o Rust do repositório oficial:

sudo pacman -S rust

Isso instala rustc e cargo como pacotes do sistema. Note que essa versão pode estar uma ou duas releases atrás da última estável.

Importante: Não misture os dois métodos. Se instalou via pacman e quer migrar para rustup, primeiro remova: sudo pacman -Rs rust

Verificar a Instalação

rustc --version
cargo --version
rustup --version
rustup show

Configurar Toolchains

O Arch é perfeito para usar features nightly, já que muitos pacotes AUR escritos em Rust podem exigir a toolchain nightly:

# Instalar nightly
rustup toolchain install nightly

# Listar toolchains
rustup toolchain list

# Definir nightly como padrão para um projeto
cd meu-projeto
rustup override set nightly

# Usar nightly pontualmente
cargo +nightly build

Para mais detalhes, consulte o Guia Completo do Rustup.

Ferramentas via AUR

O AUR (Arch User Repository) tem várias ferramentas Rust úteis. Com um AUR helper como paru ou yay:

# Instalar paru (AUR helper escrito em Rust)
sudo pacman -S --needed base-devel
git clone https://aur.archlinux.org/paru.git
cd paru
makepkg -si

# Ferramentas úteis via AUR
paru -S cargo-watch
paru -S cargo-audit
paru -S cargo-expand

# Ou instale via cargo diretamente
cargo install cargo-watch cargo-audit cargo-expand

Configurar o Editor

Para uma experiência completa de desenvolvimento no Arch:

# VS Code (AUR)
paru -S visual-studio-code-bin

# Ou Neovim (repositório oficial)
sudo pacman -S neovim

Criar um Projeto de Teste

cargo new hello-arch
cd hello-arch
cargo run

Para entender melhor os comandos do Cargo, veja nosso guia completo.

Integração com Makepkg

Se você mantém pacotes AUR escritos em Rust, adicione ao seu PKGBUILD:

makedepends=('rust' 'cargo')

build() {
    cd "$srcdir/$pkgname-$pkgver"
    cargo build --release --locked
}

package() {
    cd "$srcdir/$pkgname-$pkgver"
    install -Dm755 "target/release/$pkgname" "$pkgdir/usr/bin/$pkgname"
}

Solução de Problemas

Conflito entre pacman rust e rustup

Se encontrar conflitos de pacotes:

# Remover pacote do sistema
sudo pacman -Rs rust

# Limpar e reinstalar via rustup
rustup self uninstall
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Erro de compilação com ring ou openssl-sys

Instale as dependências do sistema:

sudo pacman -S openssl pkg-config perl

Erro: “cannot find -lz” ou linking errors

Instale a biblioteca zlib:

sudo pacman -S zlib

Próximos Passos

Com o Rust rodando no Arch Linux:

Se você também se interessa por linguagens de baixo nível, confira o ziglang.com.br para recursos sobre Zig em português.


Última atualização: 23 de fevereiro de 2026. Para remover o Rust completamente, consulte Como Desinstalar Rust.