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, 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:
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:
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:
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:
brew install rustup-init
rustup-init
Importante: Prefira
rustup-initvia Homebrew em vez debrew install rust. O pacoterustdo Homebrew não oferece gerenciamento de toolchains.
Configurar o PATH
Ative o Rust na sessão atual:
source "$HOME/.cargo/env"
O macOS moderno usa Zsh como shell padrão. Verifique se a configuração foi adicionada:
cat ~/.zshrc | grep cargo
Se não encontrar a linha, adicione manualmente:
echo 'source "$HOME/.cargo/env"' >> ~/.zshrc
source ~/.zshrc
Verificar a Instalação
rustc --version
cargo --version
rustup show
Verifique a arquitetura da toolchain instalada:
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:
# 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)
# 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.
Criar Seu Primeiro Projeto
cargo new hello-mac
cd hello-mac
cargo run
Para entender a estrutura completa de um projeto, consulte o Guia Completo do 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 ou faça a instalação rápida:
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.
Ferramentas Adicionais via Cargo
# 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:
[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:
[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:
xcode-select --install
Se já estiver instalado mas com problema, reinicie:
sudo xcode-select --reset
Erro: “library not found for -lSystem”
Após atualização do macOS, o SDK pode precisar ser reconfigurrado:
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:
brew install mold
Próximos Passos
Com o Rust funcionando no macOS:
- Siga o tutorial de Primeiros Passos com Rust
- Use o Cheatsheet Rust como referência rápida
- Configure CI/CD com GitHub Actions para seus projetos
- Explore o Rust com Docker para ambientes reproduzíveis
- Veja as Perguntas Frequentes se tiver dúvidas
Se você também desenvolve com Go no macOS, confira o 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.