什么是 ZLS？
ZLS (Zig Language Server) is a Zig 的语言服务器协议实现 written in Zig by the zigtools community. It provides developers with modern IDE features like autocomplete, goto definition, hover information, and semantic analysis in their favorite editors. With over 4k GitHub stars, it's the essential tool for productive Zig development.
⚡ Key Features of ZLS
💡 Smart Completions
Intelligent autocomplete for functions, variables, types, and imports. Context-aware suggestions based on current scope and available symbols.
🔍 Navigation Features
Goto definition/declaration, find references, and document symbols. Navigate large Zig codebases with ease and precision.
📝 Code Intelligence
Hover information, semantic token highlighting, and inlay hints. Understand code structure and types without manual lookup.
🛠️ Development Tools
Automatic formatting with zig fmt, code actions, selection ranges, and folding regions for better code organization.
🔄 Symbol Operations
Rename symbols across entire codebase, find all references, and document symbol outline for project navigation.
📦 Package Support
Custom package resolution, cImport support, and namespace handling for complex Zig projects and dependencies.
🎯 Supported Editors & IDEs
- VS Code: Official Zig extension with ZLS integration
- Neovim/Vim: Native LSP support and dedicated plugins
- Emacs: lsp-mode and eglot compatibility
- Sublime Text: LSP package integration
- Kate/KDevelop: Built-in LSP support
- Any LSP-compatible editor: Universal Language Server Protocol support
apt upgrade 即可始终保持最新版本。
📦 从 deb.griffo.io 安装
步骤 1：添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 有一个永久免费的镜像。 deb-free.griffo.io 永久免费提供软件包 — 无需账号、无需订阅，最多落后上游 2 个月，安全修复立即发布。目前收录 cliamp、Ghostty、lazydocker、Oh My Posh 和 Zed；ZLS 不在其中，因此今天只能通过上面的仓库安装 — 提出请求即可将其加入。
🧩 关于 extrepo 选项。 extrepo 是 Debian 官方用于管理第三方仓库的工具：它会替你写好 sources 文件并安装签名密钥，并在使用前先对照签名元数据校验该密钥。本仓库以 griffo 之名登记其中，永久免费镜像则为 griffo-free，因此在 Debian（bookworm、trixie、forky、sid）上，上面的命令就是全部配置。
extrepo 只负责 sources 文件和密钥，订阅凭据仍然要写入 /etc/apt/auth.conf.d/deb.griffo.io.conf。Ubuntu 不在覆盖范围内，因为 extrepo 只发布 Debian 各套件的元数据：在 Ubuntu 上请使用 sudo 或 root 的命令。
步骤 2：安装 ZLS
# Install latest stable ZLS
sudo apt install zls
# Or install nightly builds for cutting-edge features
sudo apt install zls-master
# Verify installation
zls --version# Install latest stable ZLS
apt install zls
# Or install nightly builds for cutting-edge features
apt install zls-master
# Verify installation
zls --version🎯 Editor Setup Examples
VS Code setup:
# 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"
}Neovim setup (with nvim-lspconfig):
-- In your init.lua
require('lspconfig').zls.setup{
cmd = { "zls" },
filetypes = { "zig" },
root_dir = require('lspconfig.util').root_pattern("build.zig", ".git"),
}Basic ZLS configuration:
# 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🚀 为什么选择 deb.griffo.io？
- Official Debian: ZLS not available in official repositories
- Manual Compilation: Requires Zig master and complex build process
- Binary Downloads: Manual updates and no package management
- deb.griffo.io: Latest version with automatic updates
- ✅ Latest Language Support: Get newest Zig language feature support immediately
- ✅ No Manual Compilation: Pre-built binaries, no Zig master required
- ✅ Automatic Updates: Packages updated within hours of upstream releases
- ✅ Stable & Nightly: Both stable and cutting-edge versions available
- ✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
- ✅ Easy Maintenance: Standard apt commands for updates
📦 软件包构建仓库
Debian 软件包在这些 GitHub 仓库中自动构建和维护：
- 🇿 zls-debian (stable) - Stable release builds
- 🇿 zls-master-debian (nightly) - Nightly development builds
🔗 相关软件包
也可从 deb.griffo.io 获取：
- Zig Programming Language - Required for ZLS development
- Ghostty Terminal - Modern terminal for development
- fzf Fuzzy Finder - Enhanced file navigation