---
title: "Instalar Rust no Arch Linux"
url: "https://rustlang.com.br/instalacao/arch-linux/"
markdown_url: "https://rustlang.com.br/instalacao/arch-linux.MD"
description: "Guia para instalar Rust no Arch Linux: rustup vs pacman, AUR helpers, configuração de toolchain e dicas para desenvolvimento produtivo."
date: "2026-02-23"
author: "Equipe Rust Brasil"
---

# 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](/instalacao/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étodo | Vantagens | Desvantagens |
|--------|-----------|--------------|
| **rustup** | Múltiplas toolchains, atualizações imediatas, cross-compilation | Instalação por usuário |
| **pacman** | Integrado ao sistema, gerenciado pelo pacman | Uma ú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:

```bash
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:

```bash
sudo pacman -S rustup
```

Depois de instalar o pacote, inicialize a toolchain:

```bash
rustup default stable
```

### Via Script Oficial

Alternativamente, use o script oficial:

```bash
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:

```bash
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:

```bash
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

```bash
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:

```bash
# 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](/instalacao/rustup/).

## Ferramentas via AUR

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

```bash
# 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**: Disponível no AUR como `visual-studio-code-bin`. Veja o [guia de VS Code para Rust](/instalacao/vscode/)
- **Neovim**: `sudo pacman -S neovim`. Veja o [guia de Neovim para Rust](/instalacao/neovim/)

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

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

## Criar um Projeto de Teste

```bash
cargo new hello-arch
cd hello-arch
cargo run
```

Para entender melhor os comandos do [Cargo](/instalacao/cargo/), veja nosso guia completo.

## Integração com Makepkg

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

```bash
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:

```bash
# 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:

```bash
sudo pacman -S openssl pkg-config perl
```

### Erro: "cannot find -lz" ou linking errors

Instale a biblioteca zlib:

```bash
sudo pacman -S zlib
```

## Próximos Passos

Com o Rust rodando no Arch Linux:

- Siga o tutorial de [Primeiros Passos com Rust](/tutoriais/primeiros-passos/)
- Consulte o [Cheatsheet Rust](/cheatsheet/) para referência rápida
- Configure o [Rust no Docker](/instalacao/docker/) para ambientes isolados
- Explore [Cross-Compilation em Rust](/instalacao/cross-compilation/) para compilar para outros alvos
- Veja as [Perguntas Frequentes](/faq/) para dúvidas comuns

Se você também se interessa por linguagens de baixo nível, confira o [ziglang.com.br](https://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](/instalacao/desinstalar/).*