O que é o ZLS?

O ZLS (Zig Language Server) é uma implementação do protocolo de servidor de linguagem para Zig escrita em Zig pela comunidade zigtools. Ele fornece aos desenvolvedores recursos modernos de IDE como autocompletar, ir para definição, informações ao passar o mouse e análise semântica em seus editores favoritos. Com mais de 4 mil estrelas no GitHub, é a ferramenta essencial para o desenvolvimento produtivo em Zig.

            🚀 Por que as versões mais recentes importam: O ZLS está evoluindo rapidamente junto com o próprio Zig, com lançamentos frequentes contendo suporte a novos recursos de linguagem, melhorias de desempenho e capacidades IDE aprimoradas. As versões mais recentes incluem melhor análise semântica, completions melhoradas e compatibilidade com Zig 0.14+.
        

⚡ Principais Recursos do ZLS

💡 Completions Inteligentes

Autocompletar inteligente para funções, variáveis, tipos e imports. Sugestões contextuais baseadas no escopo atual e nos símbolos disponíveis.

🔍 Recursos de Navegação

Ir para definição/declaração, encontrar referências e símbolos do documento. Navegue por grandes bases de código Zig com facilidade e precisão.

📝 Inteligência de Código

Informações ao passar o mouse, realce de tokens semânticos e dicas inline. Entenda a estrutura e os tipos do código sem consulta manual.

🛠️ Ferramentas de Desenvolvimento

Formatação automática com zig fmt, ações de código, intervalos de seleção e regiões de dobramento para melhor organização do código.

🔄 Operações de Símbolos

Renomear símbolos em toda a base de código, encontrar todas as referências e esboço de símbolos do documento para navegação no projeto.

📦 Suporte a Pacotes

Resolução de pacotes customizados, suporte a cImport e tratamento de namespaces para projetos e dependências Zig complexos.

🎯 Editores e IDEs Suportados

VS Code: Extensão oficial do Zig com integração ZLS
Neovim/Vim: Suporte nativo a LSP e plugins dedicados
Emacs: Compatibilidade com lsp-mode e eglot
Sublime Text: Integração com pacote LSP
Kate/KDevelop: Suporte LSP integrado
Qualquer editor compatível com LSP: Suporte universal ao Language Server Protocol

🆕 Novidades no ZLS 0.14.0+

Compatibilidade com Zig 0.14: Suporte completo aos últimos recursos da linguagem Zig
Análise Semântica Aprimorada: Melhor resolução de tipos e detecção de erros
Completions Melhoradas: Sugestões mais precisas e contextuais
Otimizações de Desempenho: Análise mais rápida e menor uso de memória
Melhor Tratamento de Erros: Tratamento mais robusto de código incompleto ou inválido
Depuração Aprimorada: Melhor integração com fluxos de trabalho de depuração

📦 Instalação a partir do debian.griffo.io

Passo 1: Adicionar repositório

curl -sS https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/debian.griffo.io.gpg
echo "deb https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list
sudo apt update
                

curl -sS https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/debian.griffo.io.gpg
echo "deb https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/debian.griffo.io.list
apt update
                

Passo 2: Instalar o ZLS

# Instalar a última versão estável do ZLS
sudo apt install zls

# Ou instalar compilações noturnas para recursos de ponta
sudo apt install zls-master

# Verificar instalação
zls --version
                

# Instalar a última versão estável do ZLS
apt install zls

# Ou instalar compilações noturnas para recursos de ponta
apt install zls-master

# Verificar instalação
zls --version
                

🎯 Exemplos de Configuração do Editor

Configuração do VS Code:

# Install Zig extension from marketplace
# Extension automatically detects ZLS if installed in PATH

# Or configure custom ZLS path in settings.json:
{
    "zig.zls.path": "/usr/bin/zls"
}
        

Configuração do Neovim (com nvim-lspconfig):

-- In your init.lua
require('lspconfig').zls.setup{
    cmd = { "zls" },
    filetypes = { "zig" },
    root_dir = require('lspconfig.util').root_pattern("build.zig", ".git"),
}
        

Configuração básica do ZLS:

# Create ZLS config file
mkdir -p ~/.config/zls
cat > ~/.config/zls/zls.json << 'EOF'
{
    "enable_semantic_tokens": true,
    "enable_inlay_hints": true,
    "enable_snippets": true,
    "warn_style": true,
    "highlight_global_var_declarations": true
}
EOF
        

🚀 Por que escolher o debian.griffo.io?

📊 Comparação de Repositórios:

Debian Oficial: ZLS não disponível nos repositórios oficiais
Compilação Manual: Requer Zig master e processo de compilação complexo
Downloads Binários: Atualizações manuais e sem gerenciamento de pacotes
debian.griffo.io: Última versão (0.14.0+) com atualizações automáticas

✅ Suporte à Última Linguagem: Obtenha suporte aos mais novos recursos da linguagem Zig imediatamente
✅ Sem Compilação Manual: Binários pré-compilados, sem necessidade de Zig master
✅ Atualizações Automáticas: Pacotes atualizados em horas após os lançamentos upstream
✅ Estável e Noturno: Ambas as versões estável e de ponta disponíveis
✅ Multi-Distribuição: Funciona no Bookworm, Trixie e Sid
✅ Manutenção Fácil: Comandos apt padrão para atualizações

📦 Repositório de construção de pacotes

Os pacotes do Debian são construídos e mantidos automaticamente nestes repositórios do GitHub:

🇿 zls-debian (estável) - Compilações de lançamento estável
🇿 zls-master-debian (noturno) - Compilações de desenvolvimento noturnas

🔗 Pacotes relacionados

Também disponíveis no debian.griffo.io:

Linguagem de Programação Zig - Necessário para desenvolvimento ZLS
Terminal Ghostty - Terminal moderno para desenvolvimento
fzf Fuzzy Finder - Navegação de arquivos aprimorada

            🎯 Perfeito para: Desenvolvedores Zig que desejam recursos modernos de IDE, equipes trabalhando em grandes projetos Zig, qualquer pessoa que queira autocompletar e navegação em seu editor, e desenvolvedores que apreciam ambientes de desenvolvimento produtivos.
        

🇿 Instalar a última versão do ZLS no Debian