---
title: "Instalar Rust no macOS (Apple Silicon e Intel)"
url: "https://rustlang.com.br/instalacao/macos/"
markdown_url: "https://rustlang.com.br/instalacao/macos.MD"
description: "Guia completo para instalar Rust no macOS com Xcode Command Line Tools, rustup, Homebrew e configuração para Apple Silicon M1/M2/M3 e Intel."
date: "2026-02-23"
author: "Equipe Rust Brasil"
---

# Instalar Rust no macOS (Apple Silicon e Intel)

Guia completo para instalar Rust no macOS com Xcode Command Line Tools, rustup, Homebrew e configuração para Apple Silicon M1/M2/M3 e Intel.


O macOS é uma plataforma popular para desenvolvimento Rust, e a linguagem tem excelente suporte tanto para Macs com **Apple Silicon (M1/M2/M3/M4)** quanto para **Intel**. Neste guia, vamos instalar o Rust no macOS usando o [rustup](/instalacao/rustup/), o instalador oficial.

## Pré-requisitos: Xcode Command Line Tools

O Rust precisa de um linker e ferramentas de compilação C. No macOS, elas são fornecidas pelo Xcode Command Line Tools:

```bash
xcode-select --install
```

Uma janela de diálogo aparecerá pedindo confirmação. Clique em **Instalar** e aguarde o download (pode levar alguns minutos).

Verifique a instalação:

```bash
xcode-select -p
# Saída esperada: /Library/Developer/CommandLineTools
```

> **Nota:** Você não precisa do Xcode completo (que ocupa ~12 GB). Apenas o Command Line Tools (~1.5 GB) é suficiente.

## Instalar Rust com Rustup

Execute o comando oficial no Terminal:

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

Selecione a opção **1** para instalação padrão. O rustup detecta automaticamente sua arquitetura e instala a toolchain correta:

- **Apple Silicon**: `aarch64-apple-darwin`
- **Intel**: `x86_64-apple-darwin`

### Alternativa: Instalar via Homebrew

Se você já usa o Homebrew, pode instalar o rustup por ele:

```bash
brew install rustup-init
rustup-init
```

> **Importante:** Prefira `rustup-init` via Homebrew em vez de `brew install rust`. O pacote `rust` do Homebrew não oferece gerenciamento de toolchains.

## Configurar o PATH

Ative o Rust na sessão atual:

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

O macOS moderno usa **Zsh** como shell padrão. Verifique se a configuração foi adicionada:

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

Se não encontrar a linha, adicione manualmente:

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

## Verificar a Instalação

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

Verifique a arquitetura da toolchain instalada:

```bash
rustup show active-toolchain
# Apple Silicon: stable-aarch64-apple-darwin
# Intel: stable-x86_64-apple-darwin
```

## Apple Silicon vs Intel

### Compilação Nativa

Por padrão, o Rust compila para a arquitetura do seu Mac. No Apple Silicon, os binários são nativos ARM64, com desempenho excelente.

### Cross-Compilation entre Arquiteturas

Para criar binários universais ou compilar para a outra arquitetura:

```bash
# No Apple Silicon, compilar para Intel
rustup target add x86_64-apple-darwin
cargo build --target x86_64-apple-darwin

# No Intel, compilar para Apple Silicon
rustup target add aarch64-apple-darwin
cargo build --target aarch64-apple-darwin
```

### Criar um Universal Binary (Fat Binary)

```bash
# Compilar para ambas arquiteturas
cargo build --release --target aarch64-apple-darwin
cargo build --release --target x86_64-apple-darwin

# Juntar com lipo
lipo -create \
  target/aarch64-apple-darwin/release/meu-app \
  target/x86_64-apple-darwin/release/meu-app \
  -output meu-app-universal
```

Para mais cenários de compilação cruzada, veja o guia de [Cross-Compilation em Rust](/instalacao/cross-compilation/).

## Criar Seu Primeiro Projeto

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

Para entender a estrutura completa de um projeto, consulte o [Guia Completo do Cargo](/instalacao/cargo/).

## Configurar o Editor

### VS Code (Recomendado)

O VS Code é o editor mais popular para Rust no macOS. Veja nosso [guia completo de VS Code para Rust](/instalacao/vscode/) ou faça a instalação rápida:

```bash
brew install --cask visual-studio-code
code --install-extension rust-lang.rust-analyzer
```

### Neovim

Para quem prefere o terminal, veja o [guia de Neovim para Rust](/instalacao/neovim/).

## Ferramentas Adicionais via Cargo

```bash
# Recompilação automática ao salvar
cargo install cargo-watch

# Auditoria de segurança
cargo install cargo-audit

# Linker mais rápido (melhora tempo de compilação)
brew install michaeleisel/zld/zld
```

### Otimizar Tempo de Compilação no macOS

Crie o arquivo `~/.cargo/config.toml`:

```toml
[target.aarch64-apple-darwin]
rustflags = ["-C", "link-arg=-fuse-ld=/usr/local/bin/zld"]

[target.x86_64-apple-darwin]
rustflags = ["-C", "link-arg=-fuse-ld=/usr/local/bin/zld"]
```

Ou, para versões mais recentes, use o `lld`:

```toml
[target.aarch64-apple-darwin]
linker = "clang"
rustflags = ["-C", "link-arg=-fuse-ld=lld"]
```

## Solução de Problemas

### Erro: "xcrun: error: invalid active developer path"

O Xcode Command Line Tools não está instalado:

```bash
xcode-select --install
```

Se já estiver instalado mas com problema, reinicie:

```bash
sudo xcode-select --reset
```

### Erro: "library not found for -lSystem"

Após atualização do macOS, o SDK pode precisar ser reconfigurrado:

```bash
sudo xcode-select --switch /Library/Developer/CommandLineTools
```

### Compilação lenta

O macOS usa o linker `ld` padrão, que pode ser lento para projetos grandes. Use o `zld` ou `lld` conforme descrito na seção de otimização acima. Outra opção é usar o `mold`:

```bash
brew install mold
```

## Próximos Passos

Com o Rust funcionando no macOS:

- Siga o tutorial de [Primeiros Passos com Rust](/tutoriais/primeiros-passos/)
- Use o [Cheatsheet Rust](/cheatsheet/) como referência rápida
- Configure [CI/CD com GitHub Actions](/instalacao/github-actions/) para seus projetos
- Explore o [Rust com Docker](/instalacao/docker/) para ambientes reproduzíveis
- Veja as [Perguntas Frequentes](/faq/) se tiver dúvidas

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

---

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