当前位置：首页 > news >正文

在 Ubuntu 18.04 (WSL) 上配置 LazyVim

news 2026/3/27 3:20:03

在 Ubuntu 18.04 (WSL) 上配置 LazyVim 的终极指南：解决 GLIBC 和 Tree-sitter 依赖难题

前言

在 Ubuntu 18.04 这种“古董”系统上安装现代化的 Neovim 配置（如 LazyVim）是一场噩梦。
LazyVim 要求 Neovim >= 0.10，而 Ubuntu 18.04 的apt源里只有 0.6 版本。更糟糕的是，系统底层的glibc版本仅为 2.27，导致官方的 AppImage 无法运行，最新的tree-sitter编译工具也会直接报错退出。

经过一番折腾，我总结出了一套绕过系统限制的完美方案：使用 Homebrew 管理软件包，并手动降级编译 Tree-sitter。

核心思路

放弃 apt 和 Snap：系统源太老，Snap 在 WSL 容器中常有服务连接问题。
使用 Homebrew (Linuxbrew)：它自带较新的编译链，能安装最新版 Neovim 和工具。
降级 Tree-sitter-cli：这是最关键的一步，手动编译一个兼容老系统的版本。

第一步：安装 Homebrew

既然系统自带的库太老，我们就用 Homebrew 来接管软件包管理。

# 1. 安装 Homebrew/bin/bash -c"$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 2. 配置环境变量 (根据安装结束时的提示，将以下内容加入 ~/.bashrc)(echo;echo'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"')>>~/.bashrceval"$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"# 3. 验证安装brew --version

第二步：安装 Neovim 及必备工具

LazyVim 依赖很多外部工具（搜索、Git 管理、LSP 环境）。使用 Brew 一键安装，避免版本不兼容。

# 安装 Neovim 以及 LazyVim 依赖的工具brewinstallneovim ripgrep fd lazygitgitgccnode# 验证 Neovim 版本 (必须 >= 0.9.0)nvim --version

第三步：解决 Tree-sitter 的 GLIBC 报错 (关键！)

这是最容易卡住的地方。LazyVim 的插件会自动下载最新版的tree-sitter-cli(v0.25+)，但这个版本需要 GLIBC 2.29+ 和复杂的 C++ 依赖，在 Ubuntu 18.04 上无法运行，会导致代码没有高亮。

解决方案：使用 Rust 手动编译一个旧版本 (v0.22.6)，这个版本对老系统兼容性最好。

1. 安装 Rust 环境

curl--proto'=https'--tlsv1.2 -sSf https://sh.rustup.rs|shsource"$HOME/.cargo/env"

2. 编译兼容版 Tree-sitter

# 指定安装 v0.22.6 版本cargoinstalltree-sitter-cli --version0.22.6

3. 偷梁换柱：强制 Neovim 使用我们编译的版本

为了防止 LazyVim 的包管理器 (Mason) 自动下载坏掉的新版本，我们需要建立软链接，“欺骗”Neovim。

# 1. 创建目录结构mkdir-p ~/.local/share/nvim/mason/bin# 2. 删除可能已经存在的坏文件rm-f ~/.local/share/nvim/mason/bin/tree-sitter# 3. 建立软链接 (指向 Cargo 编译的好文件)ln-sf ~/.cargo/bin/tree-sitter ~/.local/share/nvim/mason/bin/tree-sitter# 4. 验证 (确保显示 0.22.6 且不报错)~/.local/share/nvim/mason/bin/tree-sitter --version

第四步：安装 LazyVim

环境准备好后，安装 LazyVim 就很简单了。

# 1. 备份旧配置 (如果有)mv~/.config/nvim ~/.config/nvim.bakmv~/.local/share/nvim ~/.local/share/nvim.bak# 2. 克隆 LazyVim 模版gitclone https://github.com/LazyVim/starter ~/.config/nvim# 3. 移除模版的 .git 目录rm-rf ~/.config/nvim/.git

第五步：收尾工作 (Locale 和字体)

1. 修复 Locale (解决乱码/方框问题)

如果打开 Neovim 发现图标显示异常或报错Locale does not support UTF-8，执行以下命令：

# 安装语言包sudoapt-getinstall-y localessudolocale-gen en_US.UTF-8# 在 ~/.bashrc 中添加环境变量echo'export LANG=en_US.UTF-8'>>~/.bashrcecho'export LC_ALL=en_US.UTF-8'>>~/.bashrc# 使配置生效source~/.bashrc