📝 Tutorial Completo: Instalando e Configurando Neovim + LunarVim no Debian/Ubuntu
Inclui Node.js, Python, Rust, configuração de Bash/Zsh e desinstalação completa
✅ 1. Atualizar o sistema
sudo apt update && sudo apt upgrade -y✅ 2. Instalar dependências básicas
sudo apt install -y git curl wget unzip tar build-essential ripgrep fd-find python3 python3-pip python3-venv⚙️ 3. Instalar o Neovim (escolha uma opção)
🔹 Opção 1: AppImage (recomendado)
wget https://github.com/neovim/neovim/releases/latest/download/nvim.appimage
chmod u+x nvim.appimage
sudo mv nvim.appimage /usr/local/bin/nvim🔹 Opção 2: PPA (Ubuntu)
sudo add-apt-repository ppa:neovim-ppa/stable
sudo apt update
sudo apt install -y neovim🔹 Opção 3: tar.gz (/opt/nvim)
👍 Opção para renomear /opt/nvim-linux-x86_64 para /opt/nvim, garantindo compatibilidade com o resto do tutorial, que já usa /opt/nvim como caminho principal.
curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux-x86_64.tar.gz
sudo tar -xzf nvim-linux-x86_64.tar.gz -C /opt
sudo mv /opt/nvim-linux-x86_64 /opt/nvim✅ Adicionar /opt/nvim/bin no PATH (.bashrc e .zshrc):
echo 'export PATH="/opt/nvim/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="/opt/nvim/bin:$PATH"' >> ~/.zshrc
source ~/.bashrc
source ~/.zshrcVerificar:
nvim --version✅ 4. Instalar Node.js (com NVM)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
source ~/.zshrc
nvm install --lts
nvm use --ltsVerificar:
node -v
npm -v✅ 5. Instalar Python para Neovim
pip install --user pynvimsudo apt install python3-pynvim✅ 6. Instalar Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env✅ Adicionar $HOME/.cargo/bin no PATH (se necessário):
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc
source ~/.bashrc
source ~/.zshrcVerificar:
rustc --version
cargo --version✅ 7. Instalar LunarVim
LV_BRANCH='release-1.4/neovim-0.9' bash <(curl -s https://raw.githubusercontent.com/lunarvim/lunarvim/master/utils/installer/install.sh)✅ Adicionar $HOME/.local/bin no PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.bashrc
source ~/.zshrcVerificar:
lvim --version✅ 8. Instalar Nerd Fonts (opcional)
cd ~/Downloads
wget https://github.com/ryanoasis/nerd-fonts/releases/download/v3.1.1/FiraCode.zip
unzip FiraCode.zip -d ~/.fonts
fc-cache -fv✅ 9. Instalar plugins extras (opcional)
pip install --user black isort flake8
npm install -g eslint prettier typescript typescript-language-server🗑️ 10. Como desinstalar tudo
🔹 Desinstalar LunarVim
~/.local/share/lunarvim/uninstall.sh
rm -rf ~/.config/lvim ~/.local/share/lunarvim ~/.cache/lvim🔹 Desinstalar Neovim
✅ AppImage:
sudo rm /usr/local/bin/nvim✅ PPA:
sudo apt remove --purge neovim
sudo add-apt-repository --remove ppa:neovim-ppa/stable✅ tar.gz (/opt/nvim):
sudo rm -rf /opt/nvim✅ Remover outros arquivos residuais em /opt:
sudo rm -rf /opt/nvim-linux-x86_64
sudo rm -rf /opt/nvim
sudo rm -f /opt/nvim-linux-x86_64.appimage
sudo rm -f /opt/nvim-linux-x86_64.tar.gz✅ Remover arquivos no diretório home:
rm -f ~/nvim-linux-x86_64
sudo rm -rf /opt/nvim
rm -f ~/nvim-linux-x86_64.appimage
rm -f ~/nvim-linux-x86_64.tar.gz✅ Remover arquivos no diretório Downloads:
rm -f ~/Downloads/nvim-linux-x86_64
sudo rm -rf /opt/nvim
rm -f ~/Downloads/nvim-linux-x86_64.appimage
rm -f ~/Downloads/nvim-linux-x86_64.tar.gz✅ Remover arquivos no diretório ~/opt:
rm -f ~/opt/nvim-linux-x86_64
sudo rm -rf /opt/nvim
rm -f ~/opt/nvim-linux-x86_64.appimage
rm -f ~/opt/nvim-linux-x86_64.tar.gz🔹 Remover PATH do .bashrc e .zshrc:
sed -i '/\/opt\/nvim\/bin/d' ~/.bashrc
sed -i '/\/opt\/nvim\/bin/d' ~/.zshrc
sed -i '/\$HOME\/\.cargo\/bin/d' ~/.bashrc
sed -i '/\$HOME\/\.cargo\/bin/d' ~/.zshrc
sed -i '/\$HOME\/\.local\/bin/d' ~/.bashrc
sed -i '/\$HOME\/\.local\/bin/d' ~/.zshrc
source ~/.bashrc
source ~/.zshrc✅ 11. Testar se foi removido
which nvim
which lvim✅ Se não retornar nada, tudo foi removido com sucesso.
🎉 Tutorial revisado, compatível e completo!
O comando sudo mv /opt/nvim-linux-x86_64 /opt/nvim já garante que o PATH /opt/nvim/bin funciona corretamente sem alterações extras. Precisa incluir mais alguma configuração automática ou ajuste?
-
Download e extração
-
Renomeação para
/opt/nvim -
Configuração do PATH para Bash e Zsh
-
Verificação
-
Comandos de desinstalação
🧹 Desinstalação (caso necessário)
sudo rm -rf /opt/nvim
sudo rm -f /opt/nvim-linux-x86_64.tar.gz
sudo rm -f /opt/nvim-linux-x86_64
sudo rm -f /opt/nvim-linux-x86_64.appimage
rm -f ~/nvim-linux-x86_64*
rm -f ~/Downloads/nvim-linux-x86_64*
rm -f ~/opt/nvim-linux-x86_64*Limpar o PATH do .bashrc e .zshrc:
sed -i '/\/opt\/nvim\/bin/d' ~/.bashrc
sed -i '/\/opt\/nvim\/bin/d' ~/.zshrc
source ~/.bashrc
source ~/.zshrcSe quiser, posso também transformar esse tutorial em um script .sh executável. Deseja isso?
Ótima observação! Esse erro acontece porque Debian/Ubuntu mais recentes (como Debian 12, Ubuntu 22.04+) bloqueiam o pip para instalar pacotes no sistema global (para proteger o sistema).
Mas temos soluções simples! Vou explicar e sugerir a melhor:
✅ 🎯 Opção 1 (recomendada): usar o --break-system-packages
Se você não se importa em instalar globalmente:
pip install --user --break-system-packages pynvim✅ Isso resolve imediatamente sem mexer no sistema.
✅ 🎯 Opção 2: criar um ambiente virtual (recomendado se quiser isolar)
Mais seguro, evita conflitos com o sistema:
python3 -m venv ~/.venvs/lunarvim
source ~/.venvs/lunarvim/bin/activate
pip install pynvimDepois adicione o Python do venv ao PATH ou configure no LunarVim se necessário.
✅ 🎯 Opção 3: instalar via apt (versão empacotada)
sudo apt install python3-pynvim⚠️ Atenção: pode estar desatualizado no repositório da distro.
👉 Minha recomendação rápida: use opção 1 (--break-system-packages), funciona direto e sem necessidade de venv se for uso pessoal.