---
title: "Instalar Rust no Ubuntu 22.04/24.04"
url: "https://rustlang.com.br/instalacao/ubuntu/"
markdown_url: "https://rustlang.com.br/instalacao/ubuntu.MD"
description: "Guia passo a passo para instalar Rust no Ubuntu 22.04 e 24.04 com rustup, configurar PATH, VS Code e verificar a instalação corretamente."
date: "2026-02-23"
author: "Equipe Rust Brasil"
---

# Instalar Rust no Ubuntu 22.04/24.04

Guia passo a passo para instalar Rust no Ubuntu 22.04 e 24.04 com rustup, configurar PATH, VS Code e verificar a instalação corretamente.


O Ubuntu é uma das distribuições Linux mais populares entre desenvolvedores, e instalar Rust nele é um processo simples e direto. Neste guia, vamos cobrir a instalação completa do Rust no **Ubuntu 22.04 LTS** e **Ubuntu 24.04 LTS** usando o [rustup](/instalacao/rustup/), o instalador oficial recomendado pela equipe Rust.

## Pré-requisitos

Antes de instalar o Rust, você precisa de algumas dependências de compilação. Abra o terminal e execute:

```bash
sudo apt update
sudo apt install -y build-essential curl gcc make pkg-config libssl-dev
```

O pacote `build-essential` inclui o GCC, G++ e Make, que são necessários para compilar crates que dependem de código C/C++. O `libssl-dev` é necessário para crates que usam TLS/SSL, como `reqwest`.

## Instalar Rust com Rustup

Execute o comando oficial de instalação do rustup:

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

O instalador apresentará três opções:

1. **Instalação padrão (recomendada)** — instala a toolchain stable
2. **Instalação customizada** — permite escolher toolchain e componentes
3. **Cancelar** — aborta a instalação

Pressione **1** e Enter para a instalação padrão. O rustup irá baixar e instalar:

- `rustc` — o compilador Rust
- `cargo` — o gerenciador de pacotes e build system
- `rustfmt` — formatador de código
- `clippy` — linter oficial

## Configurar o PATH

Após a instalação, configure o PATH no shell atual:

```bash
source "$HOME/.cargo/env"
```

Para tornar a configuração permanente, o rustup já adiciona automaticamente a linha necessária ao seu `~/.bashrc` ou `~/.zshrc`. Verifique se a linha existe:

```bash
cat ~/.bashrc | grep cargo
```

Você deve ver algo como:

```
. "$HOME/.cargo/env"
```

Se usar **Zsh** (por exemplo, com Oh My Zsh), verifique também o `~/.zshrc`:

```bash
cat ~/.zshrc | grep cargo
```

## Verificar a Instalação

Confirme que tudo está funcionando corretamente:

```bash
rustc --version
cargo --version
rustup --version
```

A saída esperada será algo como:

```
rustc 1.83.0 (stable)
cargo 1.83.0
rustup 1.27.1
```

## Criar Seu Primeiro Projeto

Teste a instalação criando um projeto simples:

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

Você verá a mensagem `Hello, world!` no terminal. Para entender melhor a estrutura de projetos Rust, confira o [Guia Completo do Cargo](/instalacao/cargo/).

## Configurar o VS Code

O VS Code é o editor mais popular para desenvolvimento Rust. Para uma configuração completa, siga nosso [guia de VS Code para Rust](/instalacao/vscode/). Aqui está o resumo rápido:

1. Instale o VS Code:
```bash
sudo snap install code --classic
```

2. Instale a extensão **rust-analyzer** pelo marketplace do VS Code ou via terminal:
```bash
code --install-extension rust-lang.rust-analyzer
```

3. Abra seu projeto:
```bash
code hello-rust/
```

O rust-analyzer fornecerá autocompletar, verificação de tipos em tempo real, navegação por código e muito mais.

## Atualizar o Rust

Para manter o Rust atualizado, execute periodicamente:

```bash
rustup update
```

Este comando atualiza todas as toolchains instaladas. Para mais detalhes sobre gerenciamento de toolchains, consulte o [Guia Completo do Rustup](/instalacao/rustup/).

## Instalar Ferramentas Adicionais

Algumas ferramentas úteis para o dia a dia:

```bash
# Formatador de código
rustup component add rustfmt

# Linter
rustup component add clippy

# Gerador de documentação (já incluído)
rustup component add rust-docs

# Ferramenta de auditoria de segurança
cargo install cargo-audit

# Watch mode para recompilação automática
cargo install cargo-watch
```

## Solução de Problemas

### Erro: "linker `cc` not found"

Este erro ocorre quando o GCC não está instalado. Instale as dependências de compilação:

```bash
sudo apt install -y build-essential
```

### Erro: "failed to run custom build command" com OpenSSL

Muitas crates dependem do OpenSSL. Instale os headers de desenvolvimento:

```bash
sudo apt install -y libssl-dev pkg-config
```

### Comando `rustc` não encontrado após instalação

Se o terminal não reconhece o `rustc` após a instalação, o PATH não foi configurado. Execute:

```bash
source "$HOME/.cargo/env"
```

Em seguida, abra um novo terminal ou reinicie a sessão. Se o problema persistir, adicione manualmente ao seu `~/.bashrc`:

```bash
echo 'source "$HOME/.cargo/env"' >> ~/.bashrc
source ~/.bashrc
```

## Próximos Passos

Com o Rust instalado no Ubuntu, você está pronto para começar a programar. Recomendamos:

- Seguir o tutorial de [Primeiros Passos com Rust](/tutoriais/primeiros-passos/)
- Consultar o [Cheatsheet Rust](/cheatsheet/) para referência rápida
- Aprender sobre [cross-compilation](/instalacao/cross-compilation/) para compilar para outros alvos
- Explorar [Rust com Docker](/instalacao/docker/) para ambientes reproduzíveis
- Visitar as [Perguntas Frequentes](/faq/) se tiver dúvidas

Se você também programa em Go, confira o [golang.com.br](https://golang.com.br) para guias similares em português.

---

*Última atualização: 23 de fevereiro de 2026. Para desinstalar o Rust, consulte o guia [Como Desinstalar Rust](/instalacao/desinstalar/).*