Neovim 安装与配置详解：打造你的高效开发环境

在现代软件开发领域，编辑器的选择往往直接影响着开发者的效率和体验。从功能丰富的集成开发环境（IDE）到轻量级、高度可定制的文本编辑器，开发者们各有所好。而在后者阵营中，Vim 及其现代分支 Neovim，凭借其独特的模态编辑、强大的可扩展性和无与伦比的效率，俘获了大量忠实用户。

Neovim (Nvim) 是 Vim 的一个积极重构和现代化项目，旨在改进代码库、分离 UI、提升扩展性（特别是通过 Lua），并修复一些 Vim 的长期存在的痛点。它与 Vim 高度兼容，但提供了更现代的默认设置、更强大的 API 以及一个更活跃的社区。

本文将是一份详尽的指南，带你从零开始安装 Neovim，并通过逐步配置，将其打造成一个功能强大、符合个人习惯的高效开发环境。我们将涵盖基础安装、核心配置、插件管理、常用插件推荐（涵盖代码补全、语法高亮、文件浏览、模糊搜索、LSP 集成等），以及个性化定制的关键方面。准备好，让我们一起踏上 Neovim 的定制之旅！

一、 为什么选择 Neovim？

在深入配置之前，先简单阐述选择 Neovim 的几个核心优势：

1. 性能与效率： Neovim 继承了 Vim 的精髓——模态编辑。一旦熟练掌握，双手无需离开键盘即可完成绝大多数编辑操作，配合精心设计的快捷键，其编辑效率远超传统编辑器。
2. 高度可定制： Neovim 的几乎每一个方面都可以定制。从外观主题、状态栏，到编辑行为、快捷键，再到集成各种开发工具，你可以将其塑造成完全符合个人工作流的专属利器。
3. 强大的社区和生态： Neovim 拥有一个庞大且活跃的社区，贡献了成千上万的插件，覆盖了你能想到的几乎所有功能。无论是特定语言的支持、版本控制集成，还是调试工具，你都能找到相应的解决方案。
4. 现代特性： Neovim 积极拥抱现代技术，例如内置的终端模拟器、异步任务处理、对 Language Server Protocol (LSP) 的原生支持，以及将 Lua 作为一等配置和插件开发语言，使得配置更简洁、性能更优。
5. 跨平台： Neovim 可在 Linux、macOS 和 Windows 上流畅运行，确保你在不同操作系统下拥有一致的开发体验。
6. 轻量级： 相较于许多臃肿的 IDE，Neovim 启动迅速，资源占用低，即使在配置了大量插件后，依然能保持较好的性能。

二、 安装 Neovim

Neovim 的安装过程因操作系统的不同而异。以下是主流操作系统的安装方法：

1. Linux:

• Debian/Ubuntu:
  bash
sudo apt update
sudo apt install neovim
  （注意：官方仓库的版本可能较旧，推荐使用 PPA 或 AppImage 获取最新版）
  • 使用 PPA (推荐，版本较新):
    bash
sudo add-apt-repository ppa:neovim-ppa/stable # 或者 /unstable
sudo apt update
sudo apt install neovim
• Fedora:
  bash
sudo dnf install neovim python3-neovim # python3-neovim 提供 Python 插件支持
• Arch Linux:
  bash
sudo pacman -Syu neovim
• AppImage (通用，无需安装):
  从 Neovim 的 GitHub Releases 页面下载最新的 nvim.appimage 文件。
  bash
chmod u+x nvim.appimage
./nvim.appimage # 直接运行
# 或者将其移动到 $PATH 目录，如 /usr/local/bin/nvim

2. macOS:

• Homebrew (推荐):
  bash
brew install neovim
• MacPorts:
  bash
sudo port install neovim

3. Windows:

• Scoop (推荐):
  bash
scoop install neovim
• Chocolatey:
  bash
choco install neovim
• Winget:
  bash
winget install Neovim.Neovim
• 手动安装:
  从 Neovim 的 GitHub Releases 页面下载预编译的 nvim-win64.zip 文件，解压后将 bin 目录添加到系统的 PATH 环境变量中。

验证安装:
打开你的终端（Terminal, iTerm2, Windows Terminal 等），输入 nvim 并回车。如果看到 Neovim 的启动界面，说明安装成功。

bash
nvim --version # 查看 Neovim 版本及其特性支持情况

三、 初识 Neovim 与核心概念

1. 配置文件:

Neovim 的主要配置文件位于用户配置目录下。与 Vim 的 ~/.vimrc 不同，Neovim 的配置更加规范化：

• Linux/macOS: ~/.config/nvim/init.vim 或 ~/.config/nvim/init.lua
• Windows: ~/AppData/Local/nvim/init.vim 或 ~/AppData/Local/nvim/init.lua

你可以选择使用传统的 Vimscript (init.vim) 或现代的 Lua (init.lua) 来编写配置。本文强烈推荐并主要使用 Lua (init.lua)，因为它更简洁、性能更好，并且是 Neovim 社区未来的趋势。

如果 ~/.config/nvim 目录不存在，请手动创建它：mkdir -p ~/.config/nvim

2. 模态编辑:

这是 Vim/Neovim 的核心。主要模式包括：

• Normal Mode (普通模式): 默认模式，用于导航、删除、复制、粘贴等操作。按键不会直接插入文本。
• Insert Mode (插入模式): 用于输入文本。从普通模式按 i, a, o (以及它们的大写形式) 等进入。按 Esc 或 Ctrl+[ 返回普通模式。
• Visual Mode (可视模式): 用于选择文本块。从普通模式按 v (字符选择), V (行选择), Ctrl+v (块选择) 进入。按 Esc 返回普通模式。
• Command-Line Mode (命令行模式): 用于执行命令。从普通模式按 : 进入。输入命令后按回车执行，按 Esc 取消。

3. Leader 键:

Leader 键是一个特殊的前缀键，用于自定义快捷键，避免与 Neovim 内置的快捷键冲突。默认情况下未设置，通常设置为 空格键 或 ,。

在 init.lua 中设置 Leader 键为空格：
lua
-- 设置 Leader 键为空格
vim.g.mapleader = ' '
vim.g.maplocalleader = ' ' -- 本地 Leader 键 (通常也设为空格或逗号)

设置后，你可以定义形如 <Leader>f (按下空格再按 f) 的快捷键。

四、 基础配置 (init.lua)

现在，让我们开始填充 init.lua 文件，进行一些基础但重要的配置。

```lua
-- ~/.config/nvim/init.lua

-- [[ 基本设置 ]]
vim.opt.number = true -- 显示行号
vim.opt.relativenumber = true -- 显示相对行号 (与 number 结合使用)
vim.opt.mouse = 'a' -- 启用所有模式下的鼠标支持
vim.opt.ignorecase = true -- 搜索时忽略大小写
vim.opt.smartcase = true -- 如果搜索模式包含大写字母，则不忽略大小写
vim.opt.hlsearch = true -- 高亮搜索结果
vim.opt.incsearch = true -- 输入搜索模式时实时高亮匹配
vim.opt.termguicolors = true -- 启用 True Color 支持 (需要终端支持)
vim.opt.scrolloff = 8 -- 光标距离顶部/底部的最小行数
vim.opt.sidescrolloff = 8 -- 光标距离左侧/右侧的最小列数
vim.opt.wrap = false -- 禁用自动换行

-- 缩进设置
vim.opt.tabstop = 4 -- Tab 宽度为 4 个空格
vim.opt.shiftwidth = 4 -- 自动缩进宽度为 4 个空格
vim.opt.expandtab = true -- 将 Tab 转换为空格
vim.opt.autoindent = true -- 继承上一行的缩进方式
vim.opt.smartindent = true -- 智能缩进

-- 外观与界面
vim.opt.cursorline = true -- 高亮当前行
vim.opt.splitbelow = true -- 水平分割窗口时，新窗口在下方
vim.opt.splitright = true -- 垂直分割窗口时，新窗口在右侧
vim.opt.confirm = true -- 在执行可能导致数据丢失的操作前进行确认 (例如 :q!)

-- 文件处理
vim.opt.undofile = true -- 启用撤销文件，即使关闭 Neovim 后也能撤销
vim.opt.backup = false -- 关闭备份文件
vim.opt.writebackup = false -- 关闭写入备份
vim.opt.swapfile = false -- 关闭交换文件 (如果你经常意外关闭且不担心崩溃恢复，可以关闭)
vim.opt.updatetime = 300 -- 文件变更检测的延迟时间 (毫秒)，用于 GitGutter 等插件

-- 剪贴板
-- 确保 Neovim 使用系统剪贴板 (需要 'xsel', 'xclip' (Linux) 或 'pbcopy'/'pbpaste' (macOS) 支持)
vim.opt.clipboard = 'unnamedplus'

-- Leader 键 (前面已设置)
vim.g.mapleader = ' '
vim.g.maplocalleader = ' '

-- [[ 基础快捷键映射 ]]
-- 使用 键作为前缀创建自定义快捷键

-- 快速保存
vim.keymap.set('n', 'w', ':w', { silent = true, noremap = true, desc = 'Save file' })

-- 快速退出
vim.keymap.set('n', 'q', ':q', { silent = true, noremap = true, desc = 'Quit' })
vim.keymap.set('n', 'Q', ':qa!', { silent = true, noremap = true, desc = 'Quit All Force' })

-- 分屏导航 (可选，有些人喜欢默认的 Ctrl+W hjkl)
-- vim.keymap.set('n', '', 'h', { silent = true, noremap = true, desc = 'Navigate Left Split' })
-- vim.keymap.set('n', '', 'j', { silent = true, noremap = true, desc = 'Navigate Down Split' })
-- vim.keymap.set('n', '', 'k', { silent = true, noremap = true, desc = 'Navigate Up Split' })
-- vim.keymap.set('n', '', 'l', { silent = true, noremap = true, desc = 'Navigate Right Split' })

-- 取消高亮搜索
vim.keymap.set('n', '', ':nohlsearch', { silent = true, noremap = true, desc = 'Clear search highlight' })

-- 插入模式下的快捷移动 (可选)
-- vim.keymap.set('i', 'jk', '', { noremap = true, silent = true, desc = 'Exit insert mode'})

print('Neovim config loaded!') -- 可以在启动时看到此消息，确认配置已加载
```

保存 init.lua 文件并重新启动 Neovim (nvim)，你应该能看到行号、鼠标支持等效果。尝试使用 <Leader>w (空格+w) 保存文件。

五、 插件管理：使用 packer.nvim

Neovim 的强大之处在于其插件生态。我们需要一个插件管理器来方便地安装、更新和管理插件。packer.nvim 是一个用 Lua 编写的流行且高效的插件管理器。

1. 安装 packer.nvim:

首先，需要安装 Git。然后执行以下命令（根据你的操作系统选择）：

• Linux/macOS:
  bash
git clone --depth 1 https://github.com/wbthomason/packer.nvim\
~/.local/share/nvim/site/pack/packer/start/packer.nvim
• Windows (PowerShell):
  powershell
git clone --depth 1 https://github.com/wbthomason/packer.nvim "$env:LOCALAPPDATA\nvim-data\site\pack\packer\start\packer.nvim"

2. 配置 packer.nvim:

在 init.lua 的 顶部 添加以下代码来初始化 packer。将你的插件列表放在 packer.startup(function(use) ... end) 内部。

```lua
-- ~/.config/nvim/init.lua

-- [[ Packer Setup ]]
local ensure_packer = function()
local fn = vim.fn
local install_path = fn.stdpath('data')..'/site/pack/packer/start/packer.nvim'
if fn.empty(fn.glob(install_path)) > 0 then
fn.system({'git', 'clone', '--depth', '1', 'https://github.com/wbthomason/packer.nvim', install_path})
vim.cmd [[packadd packer.nvim]]
return true
end
return false
end

local packer_bootstrap = ensure_packer()

-- 自动运行 PackerCompile 当 packer.lua 文件被更改时
vim.cmd([[
augroup packer_user_config
autocmd!
autocmd BufWritePost plugins.lua source | PackerCompile
augroup end
]])

-- 使用 Packer 管理插件
require('packer').startup(function(use)
-- Packer 可以管理自身
use 'wbthomason/packer.nvim'

-- 在这里添加你的插件
-- 示例：添加一个主题插件
use 'folke/tokyonight.nvim'

-- 自动安装和同步插件
if packer_bootstrap then
require('packer').sync()
end
end)

-- [[ 你的其他配置（基本设置、快捷键等）放在 Packer 配置之后 ]]
-- ... (之前写的 vim.opt, vim.g, vim.keymap.set 等内容) ...

-- [[ 应用主题 ]]
-- 将主题设置放在 Packer 配置块之后，确保插件已被加载
vim.cmd[[colorscheme tokyonight-night]] -- 或者 tokyonight-storm, tokyonight-day

-- ... 其他配置继续 ...
```

说明:

• ensure_packer 函数检查 packer.nvim 是否已安装，如果没有则自动克隆。
• packer_bootstrap 变量记录是否是首次运行（需要同步插件）。
• autocmd BufWritePost plugins.lua (如果你将 packer 配置分离到 plugins.lua 文件) 或 init.lua (如果直接写在 init.lua) 会在保存配置文件后自动运行 PackerCompile，这对于 packer 的某些优化是必要的。不过，对于初学者，手动运行命令也可以。
• require('packer').startup(function(use) ... end) 是定义插件列表的地方。
• use 'owner/repo' 是添加插件的基本语法，指向 GitHub 仓库。
• if packer_bootstrap then require('packer').sync() end 确保在首次安装 packer 后自动同步（安装）插件。

3. 管理插件命令:

在 Neovim 中，你可以使用以下命令管理插件：

• :PackerSync：同步插件。安装新添加的插件，删除 use 语句中移除的插件，并更新已安装的插件（如果配置了更新策略）。这是最常用的命令。
• :PackerInstall：仅安装缺失的插件。
• :PackerUpdate：更新所有插件。
• :PackerClean：删除不再使用的插件。
• :PackerCompile：重新编译 packer 的加载脚本（通常自动完成）。

首次运行:
保存 init.lua 文件后，重新启动 Neovim。packer 应该会自动开始克隆 tokyonight.nvim 主题插件。如果没有自动运行，手动执行 :PackerSync。完成后，tokyonight 主题应该会被应用。

六、 必备插件推荐与配置

现在，我们来添加一系列常用插件，将 Neovim 打造成一个强大的开发环境。我们将插件添加到 packer.startup 函数内部。

```lua
-- 在 packer.startup(function(use) ... end) 内部添加：

-- Packer can manage itself
use 'wbthomason/packer.nvim'

-- [[ UI & Appearance ]]
use {
'nvim-lualine/lualine.nvim', -- 功能强大且美观的状态栏
requires = { 'nvim-tree/nvim-web-devicons', opt = true } -- 需要图标支持
}
use 'folke/tokyonight.nvim' -- 主题 (之前已添加)
use 'nvim-tree/nvim-web-devicons' -- 文件图标
use {
'nvim-tree/nvim-tree.lua', -- 文件浏览器
requires = { 'nvim-tree/nvim-web-devicons' },
}
use 'lukas-reineke/indent-blankline.nvim' -- 缩进线高亮

-- [[ Editing Enhancements ]]
use 'windwp/nvim-autopairs' -- 自动补全括号、引号等
use 'numToStr/Comment.nvim' -- 快速注释/取消注释代码 (gcc, gc)
use {
'nvim-treesitter/nvim-treesitter', -- 更智能、更快速的语法高亮与分析
run = ':TSUpdate' -- 安装后自动更新解析器
}

-- [[ Code Completion ]]
use 'hrsh7th/nvim-cmp' -- 自动补全引擎 (核心)
use 'hrsh7th/cmp-nvim-lsp' -- LSP 来源
use 'hrsh7th/cmp-buffer' -- Buffer 来源
use 'hrsh7th/cmp-path' -- 文件路径来源
use 'hrsh7th/cmp-cmdline' -- 命令行来源
use 'L3MON4D3/LuaSnip' -- Snippets 引擎
use 'saadparwaiz1/cmp_luasnip' -- 将 LuaSnip 集成到 nvim-cmp

-- [[ LSP (Language Server Protocol) ]]
use {
'neovim/nvim-lspconfig', -- Neovim 的 LSP 配置集合
requires = {
-- Automatically install LSPs to stdpath for neovim
{'williamboman/mason.nvim'},
{'williamboman/mason-lspconfig.nvim'},

  -- Useful status updates for LSP
  {'j-hui/fidget.nvim', tag = 'legacy'}, -- LSP 加载状态提示
}

}

-- [[ Fuzzy Finding ]]
use {
'nvim-telescope/telescope.nvim', -- 强大的模糊搜索工具
requires = { {'nvim-lua/plenary.nvim'} } -- Telescope 依赖
}
use 'nvim-telescope/telescope-fzf-native.nvim', { run = 'make' } -- 使用 C 编写的 fzf 排序，提升性能 (可选)

-- [[ Git Integration ]]
use 'lewis6991/gitsigns.nvim' -- 在行号区域显示 Git 状态 (添加、修改、删除)

-- [[ Other useful plugins ]]
-- use 'tpope/vim-fugitive' -- Git 命令行包装器 (经典 Vim 插件，依然好用)
-- use 'akinsho/bufferline.nvim' -- 顶部的 Buffer 标签栏
```

配置插件:

仅仅 use 插件是不够的，大部分插件都需要进行配置才能正常工作或发挥最大效用。配置通常使用 require('plugin_name').setup { ... } 的形式，放在 packer.startup 函数块之后。

```lua
-- ~/.config/nvim/init.lua
-- ... (Packer setup code) ...

require('packer').startup(function(use)
-- ... (All your 'use' statements) ...
end)

-- [[ Plugin Configurations ]]

-- Tokyonight Theme (之前已设置)
vim.cmd[[colorscheme tokyonight-night]]

-- Lualine (Statusline)
require('lualine').setup {
options = {
icons_enabled = true,
theme = 'tokyonight', -- 或 'auto' 或其他 lualine 支持的主题
component_separators = { left = '', right = ''},
section_separators = { left = '', right = ''},
disabled_filetypes = {},
always_divide_middle = true,
},
sections = {
lualine_a = {'mode'},
lualine_b = {'branch', 'diff', 'diagnostics'},
lualine_c = {'filename'},
lualine_x = {'encoding', 'fileformat', 'filetype'},
lualine_y = {'progress'},
lualine_z = {'location'}
},
inactive_sections = {
lualine_a = {},
lualine_b = {},
lualine_c = {'filename'},
lualine_x = {'location'},
lualine_y = {},
lualine_z = {}
},
tabline = {},
extensions = {'nvim-tree'} -- 让 nvim-tree 的状态栏也由 lualine 管理
}

-- NvimTree (File Explorer)
require("nvim-tree").setup({
sort_by = "case_sensitive",
view = {
width = 30,
-- side = "left", -- 默认在左侧
},
renderer = {
group_empty = true,
icons = {
show = {
file = true,
folder = true,
folder_arrow = true,
git = true,
},
glyphs = {
default = "",
symlink = "",
folder = {
arrow_closed = "",
arrow_open = "",
default = "",
open = "",
empty = "",
empty_open = "",
symlink = "",
symlink_open = "",
},
git = {
unstaged = "",
staged = "✓",
unmerged = "",
renamed = "➜",
untracked = "★",
deleted = "",
ignored = "◌",
},
},
},
},
filters = {
dotfiles = false, -- 显示隐藏文件
custom = { ".git", "node_modules", ".cache" }, -- 隐藏特定文件/文件夹
},
git = {
enable = true,
ignore = false,
},
update_focused_file = {
enable = true,
update_cwd = true, -- 当切换文件时，自动更改 nvim-tree 的根目录
},
})

-- Indent Blankline
require("indent_blankline").setup {
-- char = "▏", -- 使用竖线字符
show_trailing_blankline_indent = false,
show_current_context = true,
show_current_context_start = true,
}

-- Autopairs
require('nvim-autopairs').setup{}

-- Comment
require('Comment').setup()

-- Treesitter
require'nvim-treesitter.configs'.setup {
ensure_installed = { "c", "lua", "vim", "vimdoc", "javascript", "typescript", "python", "html", "css", "json", "yaml", "markdown", "bash" }, -- 按需添加语言
sync_install = false, -- 异步安装解析器
auto_install = true, -- 自动安装缺失的解析器
highlight = {
enable = true, -- 启用基于 Treesitter 的语法高亮
-- disable = { "c", "rust" }, -- 对特定语言禁用高亮 (如果需要)
additional_vim_regex_highlighting = false, -- 是否添加基于 Vim 正则的高亮作为补充
},
indent = {
enable = true -- 启用基于 Treesitter 的缩进 (可选，可能与 smartindent 冲突，按需选择)
},
}

-- nvim-cmp (Completion)
local cmp = require'cmp'
local luasnip = require'luasnip'

require("luasnip.loaders.from_vscode").lazy_load() -- 加载 VSCode 风格的 snippets (如果安装了 snippet 集合)

cmp.setup({
snippet = {
expand = function(args)
luasnip.lsp_expand(args.body)
end,
},
mapping = cmp.mapping.preset.insert({
[''] = cmp.mapping.scroll_docs(-4),
[''] = cmp.mapping.scroll_docs(4),
[''] = cmp.mapping.complete(), -- 触发补全
[''] = cmp.mapping.abort(), -- 关闭补全窗口
[''] = cmp.mapping.confirm({ select = true }), -- 选择并确认补全项
-- Tab 键选择下一个候选项, Shift+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" }), -- i 模式和 s 模式 (snippet 模式)
[""] = 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" }),
}),
sources = cmp.config.sources({
{ name = 'nvim_lsp' },
{ name = 'luasnip' },
{ name = 'buffer' },
{ name = 'path' },
}),
-- 外观配置 (可选)
-- window = {
-- completion = cmp.config.window.bordered(),
-- documentation = cmp.config.window.bordered(),
-- },
})

-- nvim-lspconfig & mason
require("mason").setup()
require("mason-lspconfig").setup({
ensure_installed = { "lua_ls", "tsserver", "pyright", "bashls", "html", "cssls", "jsonls", "yamlls" } -- 按需自动安装 LSP Server
})

local lspconfig = require('lspconfig')
local capabilities = require('cmp_nvim_lsp').default_capabilities() -- 获取 cmp 提供的 capabilities

-- LSP 服务器的通用配置
local on_attach = function(client, bufnr)
-- 启用 completion triggered by characters ((比如输入 "." 后))
-- client.server_capabilities.completionProvider = true -- Deprecated, use capabilities instead

local function buf_set_keymap(...) vim.api.nvim_buf_set_keymap(bufnr, ...) end
local function buf_set_option(...) vim.api.nvim_buf_set_option(bufnr, ...) end

-- Mappings.
local opts = { noremap=true, silent=true }
buf_set_keymap('n', 'gD', 'lua vim.lsp.buf.declaration()', opts) -- 跳转到声明
buf_set_keymap('n', 'gd', 'lua vim.lsp.buf.definition()', opts) -- 跳转到定义
buf_set_keymap('n', 'K', 'lua vim.lsp.buf.hover()', opts) -- 显示悬停信息
buf_set_keymap('n', 'gi', 'lua vim.lsp.buf.implementation()', opts) -- 跳转到实现
buf_set_keymap('n', '', 'lua vim.lsp.buf.signature_help()', opts) -- 显示签名帮助
buf_set_keymap('n', 'wa', 'lua vim.lsp.buf.add_workspace_folder()', opts) -- 添加工作区文件夹
buf_set_keymap('n', 'wr', 'lua vim.lsp.buf.remove_workspace_folder()', opts) -- 移除工作区文件夹
buf_set_keymap('n', 'wl', 'lua print(vim.inspect(vim.lsp.buf.list_workspace_folders()))', opts) -- 列出工作区文件夹
buf_set_keymap('n', 'D', 'lua vim.lsp.buf.type_definition()', opts) -- 跳转到类型定义
buf_set_keymap('n', 'rn', 'lua vim.lsp.buf.rename()', opts) -- 重命名
buf_set_keymap('n', 'ca', 'lua vim.lsp.buf.code_action()', opts) -- 代码操作
buf_set_keymap('n', 'gr', 'lua vim.lsp.buf.references()', opts) -- 查找引用
buf_set_keymap('n', 'e', 'lua vim.diagnostic.open_float()', opts) -- 显示行诊断信息
buf_set_keymap('n', '[d', 'lua vim.diagnostic.goto_prev()', opts) -- 跳转到上一个诊断
buf_set_keymap('n', ']d', 'lua vim.diagnostic.goto_next()', opts) -- 跳转到下一个诊断
buf_set_keymap('n', 'q', 'lua vim.diagnostic.setloclist()', opts) -- 在 location list 中显示诊断

-- 设置格式化 (如果 LSP 支持)
if client.supports_method("textDocument/formatting") then
buf_set_keymap("n", "f", "lua vim.lsp.buf.format({ async = true })", opts)
end

-- vim.cmd [[autocmd CursorHold lua vim.lsp.buf.document_highlight()]]
-- vim.cmd [[autocmd CursorHoldI lua vim.lsp.buf.document_highlight()]]
-- vim.cmd [[autocmd CursorMoved lua vim.lsp.buf.clear_references()]]
end

-- 获取所有已安装的 LSP 服务器名称
local servers = require("mason-lspconfig").get_installed_servers()

-- 循环配置每个 LSP 服务器
for _, server_name in ipairs(servers) do
lspconfig[server_name].setup {
on_attach = on_attach,
capabilities = capabilities,
-- 你可以在这里为特定的 LSP 服务器添加特殊配置
-- 例如，为 lua_ls (sumneko_lua) 进行配置：
-- if server_name == "lua_ls" then
-- settings = {
-- Lua = {
-- runtime = { version = 'LuaJIT' },
-- diagnostics = { globals = {'vim'} },
-- workspace = { library = vim.api.nvim_get_runtime_file("", true) },
-- telemetry = { enable = false },
-- }
-- }
-- end
}
end

-- Fidget (LSP Status)
require("fidget").setup()

-- Telescope (Fuzzy Finder)
local actions = require('telescope.actions')
require('telescope').setup{
defaults = {
mappings = {
i = {
[""] = actions.move_selection_next,
[""] = actions.move_selection_previous,
[""] = actions.close,
},
},
file_ignore_patterns = {"node_modules", "%.git", "%.cache"}, -- 忽略特定文件/目录
-- layout_strategy = 'vertical', -- 改变布局 (可选)
-- layout_config = { height = 0.8 },
},
pickers = {
-- find_files = { theme = "dropdown" }, -- 为特定 picker 设置主题 (可选)
},
extensions = {
fzf = {
fuzzy = true, -- Enable fuzzy finding
override_generic_sorter = true, -- Override the generic sorter
override_file_sorter = true, -- Override the file sorter
case_mode = "smart_case", -- "smart_case", "ignore_case", "respect_case"
}
}
}
-- 加载 fzf 扩展 (如果安装了 telescope-fzf-native)
pcall(require('telescope').load_extension, 'fzf')

-- Gitsigns
require('gitsigns').setup {
signs = {
add = {hl = 'GitSignsAdd' , text = '│', numhl='GitSignsAddNr' , linehl='GitSignsAddLn'},
change = {hl = 'GitSignsChange', text = '│', numhl='GitSignsChangeNr', linehl='GitSignsChangeLn'},
delete = {hl = 'GitSignsDelete', text = '_', numhl='GitSignsDeleteNr', linehl='GitSignsDeleteLn'},
topdelete = {hl = 'GitSignsDelete', text = '‾', numhl='GitSignsDeleteNr', linehl='GitSignsDeleteLn'},
changedelete = {hl = 'GitSignsChange', text = '~', numhl='GitSignsChangeNr', linehl='GitSignsChangeLn'},
},
current_line_blame = true, -- 显示当前行的 git blame 信息
current_line_blame_opts = {
virt_text = true,
virt_text_pos = 'eol', -- 'eol' (default), 'overlay', 'right_align'
delay = 1000, -- 延迟 1 秒显示
ignore_whitespace = false,
},
current_line_blame_formatter = ', -