Neovim init.lua 配置详解

本文详细解析 Neovim 配置文件 init.lua 中每个配置项的含义，涵盖基础选项、插件配置和快捷键映射。

基础选项

配置项	含义
vim.g.mapleader = " "	空格键作为 Leader 键
vim.o.background = "dark"	使用深色主题
vim.o.backup = false	关闭备份文件
vim.o.expandtab = true	Tab 转为空格
vim.o.hlsearch = false	关闭搜索高亮
vim.o.incsearch = true	开启增量搜索
vim.o.number = true	显示行号
vim.o.scrolloff = 8	滚动时保留上下文行数
vim.o.shiftwidth = 4	缩进宽度为4空格
vim.o.showmode = false	隐藏底部模式显示
vim.o.signcolumn = "yes"	固定显示符号列
vim.o.smartindent = true	智能缩进
vim.o.softtabstop = 4	退格删除4空格
vim.o.swapfile = false	关闭交换文件
vim.o.tabstop = 4	Tab 宽度为4
vim.o.termguicolors = true	启用真彩色
vim.o.updatetime = 50	触发事件超时(ms)
vim.o.winborder = "rounded"	窗口边框圆角
vim.o.wrap = false	关闭自动换行

Godot 集成

配置项	含义
paths_to_check	检测 Godot 项目的路径
is_godot_project	是否为 Godot 项目
godot_project_path	Godot 项目路径
serverstart()	启动 LSP 服务器管道

快捷键配置

配置项	含义
set_wrap() / set_nowrap()	切换换行模式
<C-h> / <C-l>	移动窗口到左/右
gj / gk	在折行间移动

插件配置

插件	配置项	含义
catppuccin	colorscheme	主题
sleuth	自动检测缩进	根据项目自动设置
noice	lsp.override	覆盖 LSP 渲染
	presets.bottom_search	底部搜索栏
	presets.command_palette	命令面板
	presets.long_message_to_split	长消息到分割窗口
treesitter	ensure_installed	预装语法解析器
	highlight.enable	启用高亮
mason	ensure_installed	LSP/DAP 服务器
lspconfig	on_attach	LSP 绑定快捷键
	basedpyright 设置	Python 类型检查
	emmet_ls	HTML 快速补全
nvim-tree	view.adaptive_size	自适应大小
	sync_root_with_cwd	同步根目录
blink.cmp	keymap.preset	默认补全键位
	sources.default	补全来源
	fuzzy.implementation	使用 Rust 模糊匹配
telescope	buffers.initial_mode	buffer 选择器默认模式
supermaven	AI 代码补全	-
conform	format_on_save	保存时格式化
	formatters_by_ft	各语言格式化工具
lualine	section_separators	分隔符样式
	filename.fmt	路径缩写格式
mini.files	文件管理器	Alt+2 打开
oil	文件管理器	Alt+1 打开
diffview	Git 对比工具	-
tiny-inline-diagnostic	内联诊断	关闭虚拟文本
bufferline	mode = "buffers"	标签页模式
bookmarks	db_path	书签数据库路径

快捷键汇总

• <leader>w/W - 切换换行
• <C-h/l> - 移动窗口
• gt/gT - 切换 buffer
• <C-n> - NvimTree
• <M-1/2> - Oil/MiniFiles
• <C-p/e> - Telescope 找文件/历史
• <leader>sg/sw - Grep 搜索
• gd/K - LSP 跳转/悬停
• <leader>ca/rn/vr - 代码操作/重命名/引用