Instalação no macOS

Instruções para instalar o NeoVim no macOS usando Homebrew ou métodos alternativos.

Usando Homebrew (Recomendado)

O Homebrew é o método mais simples e recomendado para instalar o NeoVim no macOS. Se você ainda não tem o Homebrew instalado, pode obtê-lo em brew.sh .

Instalando o Homebrew

Se você ainda não tem o Homebrew, execute:

BASH
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Instalando o NeoVim

BASH
# Instalar a versão estável
brew install neovim

# Ou instalar a versão de desenvolvimento (mais recente)
brew install --HEAD neovim
HEAD vs Stable
A versão HEAD é compilada diretamente do código fonte mais recente. É útil para acessar recursos novos, mas pode ser menos estável. Para a maioria dos usuários, a versão estável é suficiente.

Atualizando o NeoVim

Para atualizar o NeoVim no futuro:

BASH
# Atualizar para a versão mais recente
brew upgrade neovim

# Se estiver usando HEAD
brew upgrade --fetch-HEAD neovim

Dependências Recomendadas

Instale estas ferramentas adicionais para uma experiência completa:

BASH
# Ferramentas essenciais
brew install git ripgrep fd node

# Fontes com ícones (Nerd Fonts)
brew tap homebrew/cask-fonts
brew install --cask font-jetbrains-mono-nerd-font

O que cada ferramenta faz:

  • gitControle de versão e gerenciamento de plugins
  • ripgrepBusca ultra-rápida em arquivos (usado pelo Telescope)
  • fdAlternativa rápida ao find
  • nodeRuntime JavaScript (necessário para alguns servidores LSP)

Configurando o Terminal

Após instalar a Nerd Font, configure seu terminal para usá-la. No Terminal.app nativo:

  1. Abra as Preferências do Terminal ( + ,)
  2. Selecione seu perfil
  3. Clique em "Alterar" na seção "Fonte"
  4. Selecione "JetBrainsMono Nerd Font"
iTerm2
Se você usa o iTerm2, vá em Preferences → Profiles → Text → Fonte selecione a fonte instalada.

Instalação via MacPorts

Se você prefere o MacPorts ao Homebrew:

BASH
sudo port install neovim

Verificando a Instalação

BASH
# Verificar versão
nvim --version

# Executar diagnóstico completo
nvim +checkhealth

O comando checkhealth irá verificar se todas as dependências estão configuradas corretamente e mostrará avisos sobre qualquer problema encontrado.

Python e Ruby
Se você planeja usar plugins que dependem de Python ou Ruby, pode ser necessário instalar os providers correspondentes:

pip3 install pynvim
gem install neovim