Neovim 从 0 到 1 下载安装 + 美化教程（2025 最新版）

一、为什么选择 Neovim？

  • 轻量高效：安装包仅 10MB+，启动速度＜0.5秒
  • 高度可定制：支持 Lua 脚本配置，打造专属 IDE
  • 跨平台：完美支持 Windows/Linux/Mac
  • 生态丰富：海量插件（LSP 补全、语法高亮、文件树等）
  • 原生支持终端：无需额外配置，直接集成终端功能

二、环境准备

1. 系统要求

  • Windows 10/11、Linux（Ubuntu 20.04+）、Mac OS 12+
  • 已安装 Git（插件下载需要）
  • 已安装 Node.js（部分插件依赖，推荐 v18+）

2. 工具下载（官方最新版）

系统下载链接安装方式
WindowsNeovim 0.10.2 安装包双击安装，勾选「Add to PATH」，默认路径即可
Linux（Ubuntu）终端执行：sudo apt install neovim自动安装最新稳定版
Mac终端执行：brew install neovim需先安装 Homebrew（/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）

3. 验证安装

打开终端/命令提示符，输入：

nvim --version

若显示版本号（如 NVIM v0.10.2），说明安装成功。

三、核心配置：初始化 init.lua

Neovim 的配置文件为 init.lua，路径如下：

  • Windows：C:\Users\你的用户名\AppData\Local\nvim\init.lua
  • Linux/Mac：~/.config/nvim/init.lua

1. 创建配置文件

Windows：
  1. 按 Win+R，输入 %LOCALAPPDATA%\nvim，回车进入目录
  2. 右键新建「文本文档」，重命名为 init.lua（注意去掉 .txt 后缀）
Linux/Mac：
mkdir -p ~/.config/nvim
touch ~/.config/nvim/init.lua

2. 基础配置（复制粘贴到 init.lua）

-- init.lua - 完整 Neovim IDE (C/C++ VSCode 风格) 优化版

-- ================== 基础设置 ==================
vim.opt.number = true
vim.opt.relativenumber = true
vim.opt.tabstop = 4
vim.opt.shiftwidth = 4
vim.opt.expandtab = true
vim.opt.smartindent = true
vim.opt.cursorline = true
vim.opt.termguicolors = true
vim.opt.background = "dark"
vim.opt.scrolloff = 3
vim.opt.signcolumn = "yes"
vim.opt.mouse = "a"
vim.opt.clipboard = "unnamedplus"
vim.opt.updatetime = 300

vim.g.mapleader = " "

-- ================== Lazy.nvim 插件管理 ==================
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
if not vim.loop.fs_stat(lazypath) then
  vim.fn.system({
    "git","clone","--filter=blob:none",
    "https://github.com/folke/lazy.nvim.git",lazypath,
  })
end
vim.opt.rtp:prepend(lazypath)

require("lazy").setup({
  -- 主题
  { "joshdick/onedark.vim", lazy=false },

  -- 状态栏
  { "vim-airline/vim-airline" },
  { "vim-airline/vim-airline-themes" },

  -- 文件树
  { "nvim-tree/nvim-tree.lua", dependencies={"nvim-tree/nvim-web-devicons"} },

  -- Telescope
  { "nvim-telescope/telescope.nvim", branch="0.1.x", dependencies={"nvim-lua/plenary.nvim"} },

  -- Treesitter
  { "nvim-treesitter/nvim-treesitter", build=":TSUpdate" },

  -- LSP + 自动补全
  { "neovim/nvim-lspconfig" },
  { "williamboman/mason.nvim", config=true },
  { "williamboman/mason-lspconfig.nvim" },

  -- nvim-cmp
  {
    "hrsh7th/nvim-cmp",
    dependencies={
      "hrsh7th/cmp-nvim-lsp",
      "hrsh7th/cmp-buffer",
      "hrsh7th/cmp-path",
      "hrsh7th/cmp-cmdline",
      "L3MON4D3/LuaSnip",
      "saadparwaiz1/cmp_luasnip",
      "rafamadriz/friendly-snippets",
    }
  },

  -- Floaterm
  { "voldikss/vim-floaterm" },

  -- Git
  { "tpope/vim-fugitive" },

  -- 中文文档
  { "yianwillis/vimcdoc" },

  -- 缩进线
  { "Yggdroot/indentLine" },

  -- 语法高亮
  { "sheerun/vim-polyglot" },

  -- Dashboard
  { "goolord/alpha-nvim" },
})

-- ================== 主题 ==================
vim.cmd([[colorscheme onedark]])

-- ================== nvim-cmp 自动补全 ==================
local cmp = require("cmp")
local luasnip = require("luasnip")
cmp.setup({
  snippet = {
    expand = function(args)
      luasnip.lsp_expand(args.body)
    end,
  },
  mapping = cmp.mapping.preset.insert({
    ["<TAB>"] = cmp.mapping(function(fallback)
      if cmp.visible() then
        cmp.select_next_item()
      elseif luasnip.expand_or_jumpable() then
        luasnip.expand_or_jump()
      else
        fallback()
      end
    end, {"i","s"}),
    ["<S-TAB>"] = cmp.mapping(function(fallback)
      if cmp.visible() then
        cmp.select_prev_item()
      elseif luasnip.jumpable(-1) then
        luasnip.jump(-1)
      else
        fallback()
      end
    end, {"i","s"}),
    ["<CR>"] = cmp.mapping.confirm({ select = true }),
  }),
  sources = cmp.config.sources({
    { name="nvim_lsp" },
    { name="buffer" },
    { name="path" },
    { name="luasnip" },
  }),
})

-- ================== LSP ==================
require("mason").setup()
require("mason-lspconfig").setup({ ensure_installed={"clangd"} })

local capabilities = require("cmp_nvim_lsp").default_capabilities()

local on_attach = function(client, bufnr)
  local buf_map = function(mode, lhs, rhs)
    vim.api.nvim_buf_set_keymap(bufnr, mode, lhs, rhs, { noremap=true, silent=true })
  end
-- ================== 诊断配置（自动检错）- 移到 on_attach 函数外部 ==================
vim.fn.sign_define('DiagnosticSignError', { text = '✗', texthl = 'DiagnosticSignError' })
vim.fn.sign_define('DiagnosticSignWarn', { text = '⚠', texthl = 'DiagnosticSignWarn' })
vim.fn.sign_define('DiagnosticSignInfo', { text = 'ℹ', texthl = 'DiagnosticSignInfo' })
vim.fn.sign_define('DiagnosticSignHint', { text = '💡', texthl = 'DiagnosticSignHint' })

vim.diagnostic.config({
  virtual_text = true,
  signs = true,
  underline = true,
  update_in_insert = false,
  severity_sort = true,
})

vim.api.nvim_create_autocmd("CursorHold", {
  pattern = "*",
  callback = function()
    vim.diagnostic.open_float(nil, { focusable = false })
  end
})

local on_attach = function(client, bufnr)
  local buf_map = function(mode, lhs, rhs)
    vim.api.nvim_buf_set_keymap(bufnr, mode, lhs, rhs, { noremap = true, silent = true })
  end

  -- LSP 功能快捷键
  buf_map("n","gd","<cmd>lua vim.lsp.buf.definition()<CR>")
  buf_map("n","gr","<cmd>lua vim.lsp.buf.references()<CR>")
  buf_map("n","K","<cmd>lua vim.lsp.buf.hover()<CR>")
  buf_map("n","<leader>rn","<cmd>lua vim.lsp.buf.rename()<CR>")
  buf_map("n","<leader>ca","<cmd>lua vim.lsp.buf.code_action()<CR>")

  -- 保存自动格式化
  if client.server_capabilities.documentFormattingProvider then
    vim.api.nvim_create_autocmd("BufWritePre", {
      buffer = bufnr,
      callback = function() vim.lsp.buf.format({ async=false }) end,
    })
  end
end

vim.lsp.start({
  name = "clangd",
  cmd = { "clangd" },
  capabilities = capabilities,
  root_dir = vim.fs.dirname(vim.fs.find({ ".git", "compile_commands.json" }, { upward = true })[1] or vim.loop.cwd()),
  on_attach = on_attach,
})

-- ================== Treesitter ==================
require("nvim-treesitter.configs").setup({
  ensure_installed = { "c", "cpp", "lua", "python", "json" },
  highlight = { enable = true },
  indent = { enable = true },
})

-- ================== Telescope ==================
local builtin = require("telescope.builtin")
vim.keymap.set("n","<leader>ff",builtin.find_files)
vim.keymap.set("n","<leader>fg",builtin.live_grep)
vim.keymap.set("n","<leader>fb",builtin.buffers)
vim.keymap.set("n","<leader>fh",builtin.help_tags)

-- ================== Nvim-Tree ==================
require("nvim-tree").setup()
vim.keymap.set("n","<C-n>",":NvimTreeToggle<CR>")

-- ================== Floaterm ==================
vim.keymap.set("n","<F4>",":FloatermToggle<CR>")
vim.keymap.set("t","<F4>","<C-\\><C-n>:FloatermToggle<CR>")

-- ================== Git ==================
vim.keymap.set("n","<leader>gs",":Gstatus<CR>")
vim.keymap.set("n","<leader>gc",":Gcommit<CR>")
vim.keymap.set("n","<leader>gp",":Gpush<CR>")

-- ================== Dashboard ==================
local alpha = require("alpha")
local startify = require("alpha.themes.startify")
alpha.setup(startify.config)
-- ================================
-- 右键菜单（修复后版本）
-- ================================
vim.api.nvim_create_autocmd("UIEnter", {
  once = true,
  callback = function()
    -- 只删除 PopUp 菜单下的所有默认子菜单，保留父菜单（关键修复）
    pcall(vim.cmd, "aunmenu PopUp.*")

    -- 重新创建自定义子菜单（父菜单 PopUp 已存在，不会报错）
    vim.cmd([[
      " 定义子菜单：格式为「父菜单.子菜单名」，空格用 \ 转义
      silent! amenu PopUp.Go\ to\ Definition     :lua vim.lsp.buf.definition()<CR>
      silent! amenu PopUp.Find\ References       :lua vim.lsp.buf.references()<CR>
      silent! amenu PopUp.Hover                  :lua vim.lsp.buf.hover()<CR>
      silent! amenu PopUp.Rename                 :lua vim.lsp.buf.rename()<CR>
      silent! amenu PopUp.Code\ Action           :lua vim.lsp.buf.code_action()<CR>
      silent! amenu PopUp.Format                 :lua vim.lsp.buf.format()<CR>
    ]])
  end,
})

四、插件安装与生效

  1. 保存 init.lua 后，打开 Neovim：
    nvim
  2. 首次启动会自动下载 Lazy.nvim 插件管理器，等待下载完成
  3. 下载完成后，输入 :Lazy install，回车开始安装所有插件（首次安装需等待 1-3 分钟，取决于网络）
  4. 插件安装完成后，输入 :q 退出 Neovim，重新启动即可生效

五、美化效果增强

1. 主题切换

除了 onedark，推荐其他优质主题：

  • 暗黑系：folke/tokyonight.nvim（赛博朋克风）
  • 亮色系：ellisonleao/gruvbox.nvim（复古暖色调）
  • 极简系：navarasu/onedark.nvim（更细腻的 onedark 分支）

切换方法：

  1. 在 lazy.setup 中添加主题插件（如 { "folke/tokyonight.nvim" }）
  2. 执行 :Lazy install 安装
  3. 修改 vim.cmd([[colorscheme tokyonight]]) 即可

2. 字体配置（解决中文乱码/图标显示异常）

推荐字体：

  • 英文：JetBrains Mono（编程专用，支持连字）
  • 中文：思源黑体（与 JetBrains Mono 搭配无违和感）

配置方法（添加到 init.lua）：

vim.opt.guifont = { "JetBrains Mono:h12", "思源黑体:h12" } -- 调整字号 h12 为合适大小

3. 图标优化

确保 nvim-web-devicons 插件正常安装（已包含在文件树插件依赖中），若图标显示方块，说明字体不支持，安装 Nerd Fonts 即可。

六、常用快捷键汇总

快捷键功能
Ctrl+N打开/关闭文件树
<leader>ff模糊查找文件
<leader>fg模糊查找内容
gd跳转代码定义
K显示代码悬停提示
<leader>rn代码重命名
F4打开/关闭终端
yy/dd/p复制/删除/粘贴
:wq保存并退出

七、常见问题解决

1. 插件下载失败？

  • 检查网络连接（需科学上网，或替换 Git 镜像）
  • 执行 :Lazy clean 清理失败插件，再执行 :Lazy install 重新下载

2. 中文乱码？

  • 添加配置：vim.opt.fileencoding = "utf-8"
  • 确保系统字体支持中文

3. LSP 功能不生效？

  • 执行 :Mason 检查 clangd 等 LSP 服务器是否安装成功
  • 确保代码文件在项目根目录（存在 .git 或 compile_commands.json）

最终效果展示

  • 界面：极简 onedark 主题 + 清晰状态栏 + 侧边文件树
  • 功能：代码补全、语法高亮、跳转定义、模糊查找、终端集成
  • 体验：操作流畅，无冗余元素，兼顾开发效率与美观
# c语言 # 算法 # 开发语言 # 排序算法 # 学习方法
Logo
乐奇 Rokid 开放社区

更多推荐

AI 智能眼镜的柔性神经，开启轻量化人机交互新世代

AI 智能眼镜的核心诉求，是在接近传统眼镜的轻薄体积内，塞进 AI 主控芯片、摄像头、麦克风阵列、骨传导 / 扬声器、光波导显示模组、触控传感器、电池、蓝牙 / Wi-Fi 射频模块等大量器件。随着 AI 眼镜出货量快速上行，鹏鼎、弘信、则成等国内 FPC 厂商纷纷布局 AI 眼镜软板、软硬结合板量产方案，单机 FPC 价值量显著高于 TWS 耳机，带动国内柔性线路板供应链升级，倒逼国内厂商突破超

avatar 乐奇 Rokid 开放社区

听书阁：让你在 AR 眼镜上也可以读小说

戴上眼镜之后我才发现，"翻页"是个需要用手完成的动作。手机上有触屏，滑动、点按、长按选词，一整套肌肉记忆。到了 AR 眼镜上这些全没了：视野只有一小块，手上可能还拎着东西，能稳定输入的只剩嘴和眼镜腿上的几颗按键。把手机阅读器原样搬过来没有意义，得重新想一遍"读一本书"在眼镜上该拆成哪几个动作。听书阁就是这次重想的产物。它跑在 Rokid Craft 上，用 AIUI 的 Ink 写页面，四个页面加

avatar 乐奇 Rokid 开放社区
cover

Python 技术报告：从 2026 长沙 AI 构建者大会到 Rokid 生态的开发者实践

avatar 乐奇 Rokid 开放社区