Primeiros Passos

Agora que o Neovim está instalado, vamos entender como transformá-lo em uma IDE poderosa. Esta seção cobre a base de tudo: **Lua** e a **estrutura de arquivos**.

Lua vs VimScript

O Neovim suporta duas linguagens de configuração: VimScript e Lua. Neste guia, utilizaremos apenas Lua por ser mais rápida, moderna e o padrão atual da comunidade.

Não se preocupe

Você não precisa ser um programador Lua. A sintaxe que usaremos é muito parecida com um arquivo de configuração comum.

Onde configurar?

O Neovim busca suas configurações nestes locais padrão:

DIRETÓRIOS

# Linux e macOS
~/.config/nvim/

# Windows
%LOCALAPPDATA%\nvim\

O arquivo principal deve se chamar obrigatoriamente init.lua.

Seções deste Capítulo

Estrutura de Diretórios

Como organizar seus arquivos de configuração de forma modular.

Arquivo init.lua

O ponto de entrada principal onde tudo começa.

Opções Básicas

Configurações essenciais como números de linha e indentação.

Criando a estrutura inicial

Abra seu terminal e execute os comandos abaixo para preparar o terreno:

BASH (LINUX/MACOS)

mkdir -p ~/.config/nvim/lua/user
touch ~/.config/nvim/init.lua

POWERSHELL (WINDOWS)

mkdir -Force $env:LOCALAPPDATA\nvim\lua\user
New-Item -Path $env:LOCALAPPDATA\nvim\init.lua -ItemType File

Estrutura Resultante:

~/.config/nvim/
├── init.lua          # Ponto de entrada
└── lua/
    └── user/         # Seus arquivos .lua aqui

Módulos Lua

O Neovim entende que tudo dentro da pasta lua/ pode ser chamado via require("nome-do-arquivo"). Isso permite manter a configuração organizada em vários arquivos.