一、前言

LazyVim 是一个基于 Neovim 的现代编辑器配置框架,
内置 LSP、代码补全、语法高亮、格式化等功能,
让 Neovim 直接变身成 VSCode 级别的 IDE。

本教程适用于:

  • 系统:Windows 10 / 11

  • Shell:PowerShell

  • 包管理器:Scoop


二、安装 Scoop 包管理器

如果你还没有安装 Scoop,请先执行以下命令:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

安装完成后关闭再打开 PowerShell 终端。

验证安装:

scoop --version

如果能输出版本号说明安装成功。


三、安装 LazyVim 所需依赖

LazyVim 依赖一些底层工具,例如编译器、搜索工具、解压工具等。
用 Scoop 一次性安装即可:

scoop install neovim git gcc ripgrep fd unzip tree-sitter luarocks

工具说明:

工具

作用

neovim

核心编辑器

git

插件管理、配置同步

gcc

Treesitter 语法解析编译器

ripgrep

快速文本搜索(代替 grep)

fd

快速文件查找(代替 find)

unzip

解压插件包

tree-sitter

高亮与语法分析

luarocks

Lua 依赖管理器

⚠️ 如果安装时报 tree-sitter-cli 相关错误,可以稍后用 LazyVim 内置功能自动安装。


四、安装LazyVim Starter

使用 PowerShell 安装 LazyVim Starter

备份您当前的 Neovim 文件:

# 需要
Move-Item $env:LOCALAPPDATA\nvim $env:LOCALAPPDATA\nvim.bak

# 可选,但建议
Move-Item $env:LOCALAPPDATA\nvim-data $env:LOCALAPPDATA\nvim-data.bak

克隆启动器

git clone https://github.com/LazyVim/starter $env:LOCALAPPDATA\nvim

删除.git文件夹,你可以稍后将其添加到你自己的仓库

Remove-Item $env:LOCALAPPDATA\nvim\.git -Recurse -Force

五、设置 vim 命令别名(可选但推荐)

为了方便输入,你可以在 PowerShell 中把 nvim 设成 vim

Set-Alias -Name vim -Value 'nvim'

如果想让它永久生效,可以把这行加到你的 PowerShell 配置文件:

notepad $PROFILE

然后在文件末尾添加:

Set-Alias vim nvim

六、启动 LazyVim

现在运行:

vim

第一次启动时,LazyVim 会自动下载并配置插件(大约 1~3 分钟)。
等待加载完成后,你就能看到一个现代化的 Neovim 界面 🎉


七、常见问题与建议

问题

解决方案

插件安装卡顿

多等一会或重新打开 Neovim

C compiler not found

用 Scoop 安装 gccwinlibswinget install --id=BrechtSanders.WinLibs.POSIX.UCRT -e

无法联网下载插件

检查代理或手动配置 Git 的代理

启动后空白界面

删除 C:\Users\<用户名>\AppData\Local\nvim-data 后重启