Neovim 新手入門：安裝、Normal/Insert 模式、儲存退出與 lazy.nvim 外掛

安裝 nvim，切換基本模式，安全儲存或退出，並用 lazy.nvim 搭可擴充設定。

想在終端里快速改設定、搜日志、SSH 到远程机，又不愿每次开图形 IDE，Neovim 是 Vim 的现代分支：默认终端运行、可脚本化、插件生态活跃。本教程覆盖 安裝、Normal/Insert 模式、儲存退出，并介绍用 lazy.nvim 管理插件的最小配置，面向 hereink 读者常用的本地开发环境。

檢索詞是Neovim 新手入门：安装、基本模式、保存退出与 lazy.nvim。讀完应能启动 nvim、在模式间切换、安全保存或放弃修改，并有一个可扩展的 init.lua 起点。

Neovim 解决什么问题

官方文档：neovim.io/doc。安装后运行 nvim --version 确认版本；内置 :help 是最完整的参考。

在 macOS、Linux 与 Windows 安装

1. 1
   macOS（Homebrew）

   執行 brew install neovim。驗證：which nvim 与 nvim --version。若已有旧版 Vim，nvim 命令不会覆盖系统 vi。

2. 2
   Linux 發行版包

   Debian/Ubuntu：sudo apt update && sudo apt install neovim。Fedora：sudo dnf install neovim。Arch：sudo pacman -S neovim。仓库版本偏旧时，可从 GitHub Releases 下载 AppImage 或 tarball。

3. 3
   Windows

   Scoop：scoop install neovim；或 winget install Neovim.Neovim。安装后在新终端运行 nvim。

4. 4
   第一次启动

   在项目目录执行 nvim . 開啟当前目录文件树（需插件才好用；裸 Neovim 可先 nvim README.md）。按 i 進入插入模式试打几个字，再按 Esc 回到 Normal。

基本模式：Normal、Insert、Visual

保存、退出与放弃修改

# 在 Normal 模式下输入（冒号会出现在底部）
:w          " 保存当前文件
:q          " 退出（有未保存修改时会拒绝）
:wq  或  :x " 保存并退出
:q!         " 强制退出，丢弃未保存修改
ZZ          " Normal 下大写 ZZ：保存并退出（等同 :wq）

多文件时用 :wqa 全部保存、:qa! 全部放弃退出。文件名在启动参数里：nvim src/main.ts。

用 lazy.nvim 引入插件（入门）

lazy.nvim 是 Neovim 常用的 Lua 插件管理器：宣告式配置、懒加载、内置更新命令。最小步骤：

1. 1
   建立配置目录

   mkdir -p ~/.config/nvim。主文件为 ~/.config/nvim/init.lua。

2. 2
   寫入 bootstrap

   在 init.lua 粘贴 lazy 官方安装段（从 github.com/folke/lazy.nvim 的 README「Installation」复制），它会克隆 lazy 到 ~/.local/share/nvim/lazy/lazy.nvim。

3. 3
   声明第一个插件

   在 require("lazy").setup({ ... }) 里加一项，例如 treesitter 或 gruvbox 主题；保存后重启 nvim，lazy 会自动安装。

4. 4
   日常命令

   在 Neovim 里运行 :Lazy 打开管理 UI；:Lazy sync 同步插件列表。详见 lazy 仓库文档。

-- ~/.config/nvim/init.lua 结构示意（bootstrap 段请以官方 README 为准）
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
-- … 官方 git clone 引导 …
require("lazy").setup({
  { "nvim-treesitter/nvim-treesitter", build = ":TSUpdate" },
  { "ellisonleao/gruvbox.nvim" },
})

適合

经常在终端和远程机改代码、希望配置可版本控制、愿意花一次学习 Normal/Insert 的开发者。

不適合

必须 WYSIWYG 排版或重度 GUI 重构；团队统一 VS Code 且无人维护 Neovim 配置时。