奇技淫巧之花里胡哨的VIM---插件的添加与美化

奇技淫巧之花里胡哨的VIM—插件的添加与美化

一、前期准备工作

1.VIM版本要为9.0以上，自行检查，如果不是的话，使用PPA安装

sudoadd-apt-repository ppa:jonathonf/vimsudoaptupdate#Ubuntu发行版会自动更新，不需要手动sudoaptinstallvim

2.将系统中的 Node.js 升级到最新的 LTS 版本（通常推荐 v18 或 v20）
移除旧版本：

sudoaptremove nodejs

添加 NodeSource 源（安装 v20 LTS 版本）：

curl-fsSL https://deb.nodesource.com/setup_20.x|bash-

安装新版本：

sudoaptinstall-y nodejs

如果旧版没卸载干净可能会有报错，根据报错内容自行清理。

验证版本：

node-v# 输出应该类似 v20.x.x

3.安装clangd

sudoaptinstallclang clangd

4.安装插件管理器 (Vim-Plug)

curl-fLo ~/.vim/autoload/plug.vim --create-dirs\https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

二、vim配置文件

~/.vimrc

vim9script# ==========================================# 0. 插件管理 (基于 vim-plug)# ==========================================call plug#begin('~/.vim/plugged')# --- 核心大脑: LSP 与补全 ---Plug'neoclide/coc.nvim',{'branch':'release'}# --- C++ 增强 ---# 既然用了 Vim9，我们用基于 Vim9 的高性能高亮插件，比旧版正则快得多Plug'bfrg/vim-cpp-modern'# --- 界面美化 (颜值即正义) ---# 顶栏 Tab 栏和底栏状态条Plug'vim-airline/vim-airline'Plug'vim-airline/vim-airline-themes'# 经典的深色主题 (护眼)#Plug 'sainnhe/gruvbox-material'#仿VSCode主题Plug'tomasiser/vim-code-dark'# 文件树图标 (必须安装 Nerd Font)Plug'ryanoasis/vim-devicons'# --- 工程效率工具 (让手感像 IDE) ---# 左侧文件树Plug'preservim/nerdtree'# 自动成对补全括号/引号 (写代码必备)Plug'jiangmiao/auto-pairs'# 快速注释 (gcc 注释当前行)Plug'tpope/vim-commentary'# 包裹修改神器 (cs"' 把双引号改单引号)Plug'tpope/vim-surround'# --- 现代交互 ---# 模糊搜索 (像 VSCode 的 Ctrl+P)Plug'junegunn/fzf',{'do':{->fzf#install() } }Plug'junegunn/fzf.vim'# 浮动终端 (按 F2 唤出，像 VSCode 的 Ctrl+`)Plug'voldikss/vim-floaterm'# 调试器Plug'puremourning/vimspector'call plug#end()# ==========================================# 1. 基础设置 (像工程师一样思考)# ==========================================setnocompatible filetype plugin indent on syntax on# 开启真彩色支持 (必须，否则主题很丑)settermguicolors# 开启鼠标支持 (偶尔点点很方便)setmouse=a# 显示行号和相对行号 (方便跳转)setnumber relativenumber# 高亮当前行setcursorline# 永远显示左侧标志列 (防止报错时屏幕抖动)setsigncolumn=yes# 缩进设置 (C++ 标准 4 空格)setexpandtabsettabstop=4setshiftwidth=4setsofttabstop=4setautoindentsetsmartindent# 搜索忽略大小写，除非包含大写setignorecasesetsmartcase# 很多现代插件需要的更新时间设置setupdatetime=100# 也就是 Backspace 可以删掉任何东西setbackspace=indent,eol,start# --- 主题设置 ---# 设置背景为深色setbackground=dark colorscheme codedark#g:airline_theme = 'codedark'# 启用 Gruvbox Material 主题#g:gruvbox_material_background = 'hard'#colorscheme gruvbox-material# 让 Airline 自动匹配主题#g:airline_theme = 'gruvbox_material'# 开启顶部 Tab 栏 (类似 VSCode 顶部的文件标签)g:airline#extensions#tabline#enabled = 1g:airline#extensions#tabline#formatter = 'unique_tail'# 使用 Powerline 字体箭头g:airline_powerline_fonts=1# ==========================================# 2. 键位映射 (Space Leader 系统)# ==========================================# 将 Leader 键映射为空格 (现代 Vim 的标配，大拇指最方便)g:mapleader=" "# --- 常用快捷键 ---# 快速保存 (空格 + w)nnoremap<Leader>w :w<CR># 快速退出 (空格 + q)nnoremap<Leader>q :q<CR># 清除搜索高亮 (空格 + l)nnoremap<Leader>l :nohlsearch<CR># --- 窗口切换 (Ctrl + hjkl) ---nnoremap<C-h><C-w>h nnoremap<C-j><C-w>j nnoremap<C-k><C-w>k nnoremap<C-l><C-w>l# --- 插件快捷键 ---# 打开/关闭文件树 (空格 + e)nnoremap<Leader>e :NERDTreeToggle<CR># 在当前文件定位文件树位置nnoremap<Leader>f :NERDTreeFind<CR># 模糊搜索文件 (空格 + p, 习惯 VSCode 的 Cmd+P)nnoremap<Leader>p :Files<CR># 搜索代码内容 (空格 + s)nnoremap<Leader>s :Rg<CR># 浮动终端 (F2 开关)nnoremap<F2>:FloatermToggle<CR>tnoremap<F2><C-\><C-n>:FloatermToggle<CR># ==========================================# 3. Coc.nvim 深度配置 (IDE 的灵魂)# ==========================================# Tab 键选择补全inoremap<silent><expr><TAB>\coc#pum#visible() ? coc#pum#next(1) :\CheckBackspace()?"\<Tab>":\coc#refresh()inoremap<expr><S-TAB>coc#pum#visible() ? coc#pum#prev(1) : "\<C-h>"inoremap<silent><expr><CR>coc#pum#visible() ? coc#pum#confirm()\:"\<C-g>u\<CR>\<c-r>=coc#on_enter()\<CR>"functionCheckBackspace()var col=col('.')-1return!col||getline('.')[col -1]=~# '\s'endfunction# 代码导航 (gd 跳转定义, gr 查看引用, K 查看文档)nmap<silent>gd<Plug>(coc-definition)nmap<silent>gy<Plug>(coc-type-definition)nmap<silent>gi<Plug>(coc-implementation)nmap<silent>gr<Plug>(coc-references)# K 键查看光标下函数的文档 (非常常用！)nnoremap<silent>K :call ShowDocumentation()<CR>functionShowDocumentation()if(index(['vim','help'],&filetype)>=0)execute'h '.expand('<cword>')elseif(coc#rpc#ready())call CocActionAsync('doHover')elseexecute'!'.&keywordprg." ".expand('<cword>')endif endfunction# 代码重命名 (空格 + rn)nmap<leader>rn<Plug>(coc-rename)# 格式化代码 (空格 + fm)nmap<leader>fm :call CocAction('format')<CR># ==========================================# 4. Vimspector 调试配置# ==========================================nmap<F5><Plug>VimspectorContinue nmap<F9><Plug>VimspectorToggleBreakpoint nmap<F10><Plug>VimspectorStepOver nmap<F11><Plug>VimspectorStepInto

文件中已经添加了仿vscode和gruvbox主题，可根据需要自行修改。

修改完配置文件后重新打开vim，运行

:PlugInstall

安装相应的插件

然后安装 Coc 扩展,继续在vim中运行

:CocInstall coc-clangd coc-cmake coc-json coc-sh coc-vimlsp

可选：安装调试器适配器

:VimspectorInstall vscode-cpptools

三、部分配置使用说明书

前言：核心操作逻辑

在这套配置中，所有的“魔法”都基于两个核心概念：

Leader Key (空格键 Space)：这是你的“指挥官键”。几乎所有自定义的高级功能都以<空格>开头。

按下空格 + w = 保存 (Write)
按下空格 + q = 退出 (Quit)
按下空格 + l = 清除高亮 (Clear Highlight)

模式切换：

普通模式 (Normal)：默认模式，用于移动、浏览、按快捷键。按Esc总是回到这里。
插入模式 (Insert)：按i进入，像记事本一样打字。
可视模式 (Visual)：按v进入，用于选中代码块。

第一章：项目管理与文件浏览

这部分解决“如何在成百上千个文件中快速穿梭”的问题。

1. 文件资源管理器 (NERDTree)

场景：你需要查看项目目录结构，新建、删除或重命名文件。

打开/关闭侧边栏：<空格> + e
在侧边栏中的操作（光标在左侧文件树时）：
o(小写)：打开光标下的文件。
s：分屏打开（左右分屏），在对比代码时非常有用。
i：水平分屏打开（上下分屏）。
C(大写)：将当前选中的目录设置为“根目录”（进入子文件夹）。
u：返回上一级目录。
I(大写)：切换显示/隐藏文件（如.git或.o文件）。
m(关键功能)：唤出菜单。按m后你会看到底部出现选项：
输入a：新建文件或文件夹（输入名字以/结尾自动变成文件夹）。
输入d：删除当前文件。
输入m：重命名/移动文件。

2. 模糊搜索神器 (FZF - Files)

场景：你知道文件名，想秒开，不希望在目录树里一层层点。

启动搜索：<空格> + p
使用技巧：
模糊匹配：找driver/usb/usb_core.c，只需输入drusbc即可匹配。
打开方式：
Enter：直接打开。
Ctrl + x：在上下分屏中打开。
Ctrl + v：在左右分屏中打开。
Ctrl + t：在新标签页 (Tab) 中打开。

3. 全局代码搜索 (RipGrep - Rg)

场景：你想找MyStruct结构体在哪些文件里被定义或使用了。

启动搜索：<空格> + s
使用技巧：
输入代码片段，列表会实时更新。
按Enter跳转到对应行。
高级技巧：搜索完毕后，按Alt + a可以把所有搜索结果放入 QuickFix 列表，方便批量处理（配合:copen）。

第二章：代码编写与智能辅助 (IDE 核心)

这部分由Coc.nvim提供支持，体验类似 VS Code。

1. 智能补全

触发：输入代码时自动弹出。
选择：
Tab：向下选择。
Shift + Tab：向上选择。
Enter：确认选中。
参数提示：当你输入函数参数时（例如func(），如果配置正确，Vim 会在悬浮窗提示当前应该是哪个参数（int a, string b…）。

2. 代码导航 (跳转)

这是阅读大型 C++ 项目（如 Linux 内核或 BSP）时的神技。

跳转到定义 (Go Definition)：gd
光标在func()上按gd，直接跳到函数实现处。
跳转到引用 (Go References)：gr
想看谁调用了这个函数？按gr，会弹出一个列表显示所有调用点。
查看文档 (Hover)：K(大写)
光标下的变量类型是什么？函数注释是什么？按K查看悬浮窗。
跳转历史 (Time Travel)：
Ctrl + o：回到上一个位置（比如你按gd跳走了，看一眼想回去，就按这个）。
Ctrl + i：前进到下一个位置。

3. 诊断与修复 (报错处理)

实时报错：代码写错时，行号左边会出现红色>>或E标志，代码下方有波浪线。
查看报错详情：
光标移到波浪线上，稍微停顿，会显示错误信息。
或者按[g（跳转到上一个错误）和]g（跳转到下一个错误）。
快速修复 (Quick Fix)：
如果在报错行按<空格> + a(CocAction)，如果有自动修复方案（如缺少头文件），它会提示你直接应用。

4. 代码重构

重命名 (Rename)：<空格> + rn
修改变量名，项目中所有引用该变量的地方都会自动修改（比简单的查找替换安全得多）。
格式化 (Format)：<空格> + fm
调用clang-format自动排版当前文件。

第三章：极速编辑

这部分是 Vim 超越普通 IDE 的地方，主要依靠vim-surround和auto-pairs。

1. 包裹修改 (Surround) - 必须掌握

口诀：c(改变),d(删除),y(添加),s(Surround 包裹物)。

场景 A：把双引号改单引号
代码："Hello World"
操作：光标在引号内，按cs"'(Change Surround " to ')
结果：'Hello World'
场景 B：删除括号
代码：(int a)
操作：光标在括号内，按ds((Delete Surround ()
结果：int a
场景 C：给单词加括号/引号 (最常用)
代码：return x;-> 想变成return (x);
操作：光标在x上，按ysiw)(You Surround Inner Word with ) )
结果：return (x);
注：如果按ysiw((左括号)，会在括号内加空格( x )；按右括号则不加空格。

2. 快速注释

注释当前行：gcc
注释多行：

按v进入可视模式。
按j或k选中多行。
按gc。

解开注释：重复上述操作即可。

3. 括号补全

输入(自动补全)，光标在中间。
输入{并回车，自动补全}并换行缩进（C++ 写函数时极爽）。

第四章：窗口与终端管理

1. 窗口分屏与切换

场景：左边看头文件header.h，右边写实现source.cpp。

分屏操作：
:vsp(Vertical Split)：左右分屏。
:sp(Split)：上下分屏。
窗口间移动光标（已配置为快捷键）：
Ctrl + h：去左边窗口。
Ctrl + l：去右边窗口。
Ctrl + j：去下边窗口。
Ctrl + k：去上边窗口。
调整窗口大小：
:vertical resize +5(增加宽度)
:vertical resize -5(减小宽度)
或者直接用鼠标拖动分界线（因为开启了set mouse=a）。

2. 浮动终端

场景：编译代码、Git 提交，不需要退出 Vim。

开关终端：F2
使用逻辑：

按F2弹出终端。
输入g++ main.cpp && ./a.out。
看完结果，再次按F2隐藏（后台保持运行）。

新建终端：如果在浮动终端内想再开一个 Tab，通常命令是:FloatermNew。

第五章：调试 (Vimspector)

调试流程完全模仿 VS Code。

1. 准备工作 (每个项目只需一次)

在项目根目录创建.vimspector.json。如果没有这个文件，按 F5 会提示输入配置。

2. 调试快捷键

F9：打断点/取消断点。
F5：启动调试 / 继续运行(Continue)。
F3：停止调试。
F4：重启调试。
F10：单步跳过(Step Over) - 不进入函数内部。
F11：单步进入(Step Into) - 进入函数内部。
F12：单步跳出(Step Out) - 执行完当前函数并返回。

3. 调试界面交互

查看变量：调试时，左侧窗口会显示Variables。你可以像编辑文本一样，把光标移过去，按Enter展开结构体或类。
观察 (Watch)：在变量窗口，你可以输入:VimspectorWatch my_var来单独监视某个变量。
鼠标悬停：调试时，把鼠标放在代码里的变量上，会显示当前的值。