DEV Community

Cover image for Guia para usar o Terminal como uma IDE com Neovim e AstroNvim
Marlon Frade
Marlon Frade

Posted on

Guia para usar o Terminal como uma IDE com Neovim e AstroNvim

Você já se perguntou se poderia usar o terminal como uma IDE? Isso pode parecer estranho para alguns, mas é totalmente possível com o uso do Neovim e do AstroNvim. Este guia vai te ajudar a transformar o seu terminal em uma ferramenta de desenvolvimento poderosa.

O que é Neovim e AstroNvim?

Neovim é um fork do Vim que foi desenvolvido para melhorar a performance, estabilidade e extensibilidade do editor de texto. Ele é compatível com a maioria dos plugins do Vim e oferece suporte a várias linguagens de programação.

AstroNvim é uma pré-configuração para o Neovim que inclui uma série de recursos essenciais para desenvolvedores, como destaque de sintaxe, diagnósticos de linguagem, formatação, linting, integração com o Git e um explorador de arquivos. Além disso, é altamente personalizável, permitindo que você configure o editor da maneira que mais lhe convier.

Configuração

Antes de começar a usar o Neovim e o AstroNvim, você precisa instalá-los. Para isso, é necessário ter o pacote neovim instalado em seu sistema operacional. Em seguida, você pode instalar o AstroNvim.

AstroNvim é uma configuração que adiciona recursos essenciais ao Neovim, permitindo que você use o Terminal como uma IDE. Ele inclui destaque de sintaxe, diagnósticos de idioma, formatação, linting, integração Git e um explorador de arquivos, tornando-o uma opção moderna e altamente personalizável para a edição de código.

Instalação e Configuração

Instalação

Para começar, você precisará ter o Neovim instalado no seu sistema. Depois de instalá-lo, você pode clonar o repositório AstroNvim do GitHub com o seguinte comando:



git clone https://github.com/LunarVim/LunarVim.git ~/.config/nvim


Enter fullscreen mode Exit fullscreen mode

Isso criará uma pasta chamada nvim em seu diretório de configuração e configurará o Neovim para usar o AstroNvim.

Configuração

Primeiro, inicie o seu neovim com o comando nvim e deixe que o Lazy faça o download de todas as dependências do Astro. Assim que finalizado, você pode sair usando o tecla q .

Para configurar seu vim, utilize o repositório user_example como template para criar seu repositório de configuração.

Image description

Após criar o seu repositório, clone ele para suas configurações utilizando o comando como no exemplo abaixo:

Lembre-se de substituir o User e username pelo seu repositório específico.



git clone git@github.com:User/username_config.git ~/.config/nvim/lua/user


Enter fullscreen mode Exit fullscreen mode

Agora navegue até o diretório clonado para iniciarmos as configurações e primeiras navegações do seu AstroNvim.



cd ~/.config/nvim/lua/user
nvim


Enter fullscreen mode Exit fullscreen mode

O lazy irá carregar novamente, aguarde finalizar e feche com a tecla q por enquanto.

Uso do AstroNvim

O AstroNvim vem com uma série de plugins pré-instalados que adicionam recursos adicionais ao Neovim. Alguns dos plugins incluídos são:

  • nvim-lspconfig
  • nvim-treesitter

Alguns recursos úteis incluem:

  • :LspInstall: instala servidores de linguagem para oferecer recursos mais avançados, como auto-completar, refatoração e documentação.
  • :LspInfo: mostra informações sobre o servidor de linguagem atual.
  • :Git: abre a interface do Git para realizar ações como adicionar, commitar e pushar alterações.

Astro segue uma convenção de tecla de atalho, em que a maioria das ações são acionadas pressionando a tecla espaço, seguida de outra tecla. Por exemplo, é possível pressionar espaço seguido de e para abrir o explorador de arquivos. Dentro do neo-tree, é possível navegar usando as teclas hjkl. Para abrir diretórios, é possível usar a tecla l, e para fechá-los, a tecla h.

Para maiores configurações, você pode acessar a documentação LSP Contendo um tutorial mais completo a respeito do astroNvim e das configurações acessando cada arquivo. Além da documentação Debugger. Por hora, iremos configurar apenas o padrão.

Comandos Para o AstroNvim

Comando simples

Comando Descrição
Space Esta é a tecla líder no AstroVim. É usada para acionar a maioria das ações no AstroVim.
Space + e Isto abre o explorador de arquivos no AstroVim.
hjkl Estas teclas são usadas para navegar dentro do explorador de arquivos NeoTree.
l Esta tecla é usada para abrir um diretório no NeoTree.
h Esta tecla é usada para fechar um diretório no NeoTree.
Space + o Isto retorna o foco para o NeoTree.
Ctrl + s Isto é usado para salvar as alterações em um arquivo.
Ctrl + q Isto é usado para sair do AstroVim.
Space + n Cria um novo arquivo
Space + h Abre a tela inicial do AstroNvim

Estrutura de Arquivos de Configuração



├── highlights
│   ├── duskfox.lua
│   └── init.lua
├── init.lua
├── mappings.lua
├── options.lua
└── plugins
    ├── community.lua
    ├── core.lua
    ├── mason.lua
    ├── null-ls.lua
    ├── treesitter.lua
    └── user.lua


Enter fullscreen mode Exit fullscreen mode

Init.lua

O Astro utiliza a linguagem Lua, uma linguagem simples de script para configuração. O seu arquivo init.lua contém algumas configurações importantes como updater , colorscheme , formatting dentro da configuração LSP , e uma função polish que pode rodar qualquer código no final da inicialização.

Mappings.lua

Dentro do arquivo mappings.lua podemos mapear nossas teclas, usando configurações separadas por modo. No arquivo mappings.lua, temos a letra "N" como "Normal Mode", "T" para terminal, "I" para o "Insert Mode" e "V" para o "Visual Mode". Caso queira criar algum atalho utilizando a Tecla Espaço, você poderia adicionar um novo comando dentro do modo "N" como no exemplo abaixo:

Image description

O comando é um exemplo de como printar "Hello World" usando apenas os atalhos Espaço + Tecla a .

Para executar um comando, lembre-se de finalizar utilizando o comando cr que funciona como "Carriage Return" para a tecla Enter.

Pasta Plugins

Para configurar plugins no AstroNvim, você pode editar os arquivos dentro da pasta plugins. Para melhor compreensão segue as especificações de alguns arquivos importantes e suas respectivas configurações.

Treesitter.lua

Um arquivo que retorna uma configuração para o treesitter, que é um "Code Highlighter" que auxilia na visualização do código. Para utilizá-lo, você precisa adicionar os Languages Parsers, ou dentro da chave "OPTS" (utilizando o ensure_installed) ou utilizando o comando :TSInstall

Mason.lua

Um arquivo que contém configurações sobre múltiplos plugins que podem ser baixados e configurados para utilizar, como Language Servers, Linters, Formatters e Debuggers. Por hora, mantenha o arquivo na seguinte configuração:

Você pode encontrar um Package List do Mason nesse link.

Image description

User.lua

Neste arquivos adicionaremos configurações de plugins que adicionamos fora do AstroNvim. Para isso utilizaremos um exemplo do repositório TODO comments , certifique de possuir todos os requerimentos para instalação do pacote, como uma patched font e o ripgrep por exemplo. Utilizando a configuração padrão de acordo com o repositório temos o arquivo da seguinte maneira:

Image description

Para configurar mais a fundo nossos plugins instalados, precisamos entender melhor como funciona o gerenciador LAZY.

Lazy Events

O gerenciador de plugins Lazy do AstroVim é configurado para carregar plugins de forma preguiçosa (lazy) por padrão, com o objetivo de melhorar a performance. O termo "Lazy" faz referência à preguiça em carregar todos os plugins de uma vez só. É possível especificar eventos, comandos ou atalhos que carregam o plugin. Caso deseje desativar o carregamento preguiçoso, basta definir a chave "lazy" como false. Neste caso, para carregar o plugin quando um arquivo é aberto, utilize o evento "User AstroFile". Existem outros eventos comuns que podem ser utilizados para carregar plugins, sendo o evento "VeryLazy" útil para carregar plugins na inicialização. Depois de reiniciar, é possível observar o Lazy instalando o novo plugin.

Evento Quando é acionado
User AstroFile Acionado quando um arquivo é aberto
VeryLazy Acionado assim que o Neovim é iniciado
BufEnter * .lua Acionado ao abrir um arquivo Lua
InsertEnter Acionado ao iniciar o Insert Mode
LspAttach Acionado depois de iniciar os LSPs

Sendo que os eventos podem ser um ou mútiplos:



event = "User AstroFile"
ou
event = {"InsertEnter", "User AstroFile"}


Enter fullscreen mode Exit fullscreen mode

Agora que já entendemos como funciona o gerenciador Lazy, podemos continuar configurando nosso plugin TODO. Para isso, temos o arquivo user.lua editado.

Image description

A chave event está relacionado ao formato de carregamento do Lazy. Como definimos para o evento somente carregar o Plugin quando o arquivo estiver aberto, podemos usar a chave cmd, para configurar algum comando que desejamos realizar fora do AstroNvim. As keys funcionam da mesma maneira que no arquivo mappings.lua, podendo ser adaptadas para um atalho novo, como no exemplo que usei as teclas Espaço + T (maiúsculo) para que funcione como o comando que abre o Telescope para visualizar meus TODOs.

AstroNvim Community

Uma das features que o AstroNvim entrega é a sua comunidade de plugins, contendo configurações simplificadas para instalar plugins dentro do AstroNvim.

Caso você deseje dar uma olhada nos plugins criados ou feitos pela comunidade. Você pode acessar o repositório da comunidade AstroNvim. A comunidade facilita a instalação dos plugins, permitindo ao usuário que adicione plugins para gestão de projetos, colorscheme para personalização da IDE, e languages packs com apenas uma linha de comando, como no exemplo.

Image description

Features do AstroNvim

Which-Key

Ao pressionar uma tecla de comando como o espaço, um popup de opções irá aparecer no painel da IDE para autocompletar o seu comando, ou seja, o AstroNvim sempre lhe dará sugestões de comando ao pressionar uma tecla gatilho. Os sub-menus com mais opções estará destacado de azul

Telescope

Para abrir o telescope, temos com o exemplo o comando space + ff e o space+fo, ao entrar em algum desses modos, por padrão você estará no modo de Inserção. para buscar, comece a digitar, e use os atalhos ctrl+j e ctrl+k para navegar nos arquivos. Do lado direito, onde aprece uma pré do arquivo, você pode utilizar os comandos ctrl+d e ctrl+u para navegar para cima e para baixo nos arquivos visualizados. Ao clicar em esc você sai do modo de Inserção e volta ao modo normal, permitindo que navegue no campo de busca utilizando os comandos hl para navegar na caixa de pesquisa e os comando jk para navegar nos arquivos buscados. Use o comando ? para abrir um popup de opções de comandos. Use os comandos ctrl+p e ctrl+n para retornar e avançar nas últimas buscas feitas. use os comandos espaço+fw e espaço+fc, para procurar palavras específicas e para procurar por palavras semelhantes a que está no seu cursor.

Um outro atalho importante não mencionado aqui, é o space+/ que comenta as linhas selecionadas ou a linha atual que está digitando.

Buffers

Para criar um novo buffer, utilize o space+n e para fechar, utilize o space+c, para navegar entre as abas, utilize o comando [+b e ]+b

NeoTree

Para abrir o gerenciador de arquivos, utilize o comando space+e e para visualizar os demais comandos, utilize o ?. Alguns comandos úteis incluem o space+H para mostrar e esconder arquivos escondidos como .git por exemplo. A tecla a permite que você crie arquivos ou diretórios, enquanto que as teclas r e d permitem que você delete os arquivos.

Splits

O comando space+o muda o foco entre o neotree e os buffers, utilize o comandos ctrl+l e ctrl+h para navegar entre buffer e neotree também. Utilize o comando space+\ para dividir o buffer horizontalmente. Utilize o comando ctrl+| para dividir verticalmente, e o ctrl seguido das teclas de navegação hjkl permitem que você navegue entre as "split buffers". Para redimensionar utilize o ctrl seguido da teclas com seta de navegação (Arrow Keys) e para fechar use o comando ctrl+q, utilizando as teclas < ou > seguido da tecla b você move o seu buffer para esquerda ou direita, respectivamente.

Git Integration

Utilize o comando espaço + g para ver as opções possíveis de integração entre o AstroNvim e o Git.

Language Support

O AstroNvim pode auxiliar no suporte a linguagem, alguns dos atalhos mais úteis estão nessa tabela de exemplo:

Key Descrição
Ctrl+espaço Completar código automaticamente durante a digitação
Ctrl+e Fechar a janela de completar código
K Mostrar uma prévia do tipo do símbolo sob o cursor
gT Ir para a definição de tipo de um símbolo
Ctrl+o Voltar da definição de tipo de um símbolo
gI Ir para a implementação de um símbolo
gd Ir para a definição de um símbolo
gr Mostrar referências de um símbolo em todo o projeto
gl Ver a mensagem completa de erro
gl(gl novamente) Ir para dentro da janela pop-up da mensagem de erro
q Fechar a janela pop-up da mensagem de erro
[ Ir para o erro anterior
] Ir para o próximo erro
leader l D Ver todas as mensagens de diagnóstico no buffer
leader l r Renomear símbolos
leader l f Formatar o buffer
leader l a Exibir ações de código e aplicá-las
Enter Aplicar ação de código selecionada
F7 Alternar terminal flutuante
jj or jk Substituir o pressionamento da tecla Esc na inserção de texto
Ctrl+clique em um símbolo Ir para a definição de um símbolo
Clicar nas migalhas Ir para uma parte específica do código
Mouse Usar o mouse para selecionar, focar, mudar e fechar buffers, abrir arquivos, selecionar guias, mudar branches git e ver informações detalhadas de LSP
Alt Selecionar um bloco de texto
leader Shift+s, s Salvar sessão
leader Shift+s, . Carregar sessão

Conclusão

O AstroNvim é uma ótima opção para quem deseja usar o Terminal como uma IDE. Com suas configurações pré-configuradas e plugins, você pode melhorar significativamente sua eficiência e produtividade na edição de código. Com o suporte a servidores de idiomas e o gerenciador de plugins Lazy, você pode personalizar sua experiência de edição de acordo com suas necessidades específicas. Espero que este guia o ajude a começar a usar o AstroNvim em seu projeto! Usando o AstroNvim, podemos transformar nosso terminal em uma poderosa IDE para programação. Com recursos avançados de edição de texto, integração com Git e servidores de linguagem, o AstroNvim pode ajudar a melhorar a eficiência e produtividade do nosso fluxo de desenvolvimento. Ao seguir as etapas descritas neste guia, podemos instalar e configurar facilmente o AstroNvim em nosso terminal e começar a escrever código com mais facilidade.

Top comments (3)

Collapse
 
ingridqueiroz profile image
Ingrid Queiroz

Adorei, super explicativo!!

Collapse
 
lemuelsousa profile image
Lemuel de Sousa

Muito bom.

Collapse
 
madsonlimabr profile image
Madson Lima

Achei bem legal o post. Parabéns!