- A+
问题背景
公司配发的电脑是 macOS，日常开发需要访问 Linux 虚拟机，出于安全方面的考虑，只能通过跳板机登录。这阻止了大多数远程图形界面的使用，让写代码的工作变得复杂起来，市面上非常好用的 VSCode 都用不了。因此考虑基于 vim 搭建一套个人开发环境，需要支持以下特性：
- 语法高亮 (风格可切换)
- 自动格式化
- 函数或变量定义跳转
- 函数或变量引用跳转
- 成员函数或变量下拉列表提示
- 函数或变量 TAB 键自动补齐
- 快速查找
- ……
考察了多种方案后，决定基于目前比较流行的 neovim 来打造，不过它面向的是比较新的 Linux 发行版，不知道我这个老的 CentOS7 能不能带起来，本文就是一个探索过程。
系统环境
开始之前，先罗列下老旧系统的配置：
- 硬件
- CPU： 2.40GHz * 2 核
- 内存： 16G
- 存储： 40G + 100G
- 软件
- 系统：CentOS Linux release 7.9.2009 (Core)
- kernel：3.10.0-1160.21.1.el7.x86_64
- rpm：4.11.3
- gcc：4.8.5 (备选 8.2)
- glibc：2.17
- make：GNU make 3.82
- openssl：1.0.2k
- git：1.8
- wget：1.14
- python: 3.6.8
确实是老旧，都是公司成本控制的泪~
软件安装
整个搭建过程是比较坎坷的，常常是装了 Z 之后才发现它依赖 X、Y，去安装 X、Y 的时候又发现一坨问题……这里为了直接上手，改为正叙模式，按这个方式一步步安装、升级，应该是没问题的。如果你的系统上已经存在依赖的软件且版本一致或更新，可以忽略对应安装过程。
在 Linux 上安装软件，一般有源码安装和包管理器安装两种方式，后者在 CentOS 上就是 yum 了，然而软件源提供的软件一般版本较低，有时需要使用前者，这就比较依赖 wget、git、gcc 和 make 了，这也是在上一节中列出他们版本的原因，在开始安装各种软件之前，需要首先升级他们。
基础软件升级
gcc
系统提供的 4.8.5 编译基本是够用的，后面代码格式化需要用到的 clang-format 模块如果是源码方式安装，要求 gcc 至少是 5.1，如果你有 5.1 及以上的 gcc 那更好。没有也没关系，本文会用其它方式绕过，毕竟升级 gcc 是一项大工程，没有半天是搞不定的，太耽误功夫。
虽然不必升级 gcc，但是一些代码库使用的高版本 gcc 默认了 -std=c99 选项，这点对老版本非常不友好，为此需要特意告诉老 gcc 编译器这个选项。具体就是修改 gcc 的 spec 文件，首先是确认当前系统 gcc 加载的 spec 文件：
> strace -e file gcc 2>&1 | grep specs access("/usr/lib/gcc/x86_64-redhat-linux/4.8.5/specs", R_OK) = -1 ENOENT (No such file or directory) access("/usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../../x86_64-redhat-linux/lib/x86_64-redhat-linux/4.8.5/specs", R_OK) = -1 ENOENT (No such file or directory) access("/usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../../x86_64-redhat-linux/lib/specs", R_OK) = -1 ENOENT (No such file or directory) access("/usr/lib/gcc/x86_64-redhat-linux/specs", R_OK) = -1 ENOENT (No such file or directory)目前看是没有，需要使用 gcc 析出一份默认的：
> sudo bash -c 'gcc -dumpspecs > /usr/lib/gcc/x86_64-redhat-linux/4.8.5/specs'注意析出的路径就是上面加载路径中的第一条，内容如下：
查看代码
*asm: %{m32:--32} %{m32|mx32:;:--64} %{mx32:--x32} %{!mno-sse2avx:%{mavx:-msse2avx}} %{msse2avx:%{!mavx:-msse2avx}} *asm_debug: %{!g0:%{gstabs*:--gstabs}%{!gstabs*:%{g*:--gdwarf2}}} %{fdebug-prefix-map=*:--debug-prefix-map %*} *asm_final: %{gsplit-dwarf: objcopy --extract-dwo %{c:%{o*:%*}%{!o*:%b%O}}%{!c:%U%O} %{c:%{o*:%:replace-extension(%{o*:%*} .dwo)}%{!o*:%b.dwo}}%{!c:%b.dwo} objcopy --strip-dwo %{c:%{o*:%*}%{!o*:%b%O}}%{!c:%U%O} } *asm_options: %{-target-help:%:print-asm-header()} %{v} %{w:-W} %{I*} %a %Y %{c:%W{o*}%{!o*:-o %w%b%O}}%{!c:-o %d%w%u%O} *invoke_as: %{!fwpa: %{fcompare-debug=*|fdump-final-insns=*:%:compare-debug-dump-opt()} %{!S:-o %|.s | as %(asm_options) %m.s %A } } *cpp: %{posix:-D_POSIX_SOURCE} %{pthread:-D_REENTRANT} *cpp_options: %(cpp_unique_options) %1 %{m*} %{std*&ansi&trigraphs} %{W*&pedantic*} %{w} %{f*} %{g*:%{!g0:%{g*} %{!fno-working-directory:-fworking-directory}}} %{O*} %{undef} %{save-temps*:-fpch-preprocess} *cpp_debug_options: %{d*} *cpp_unique_options: %{!Q:-quiet} %{nostdinc*} %{C} %{CC} %{v} %{I*&F*} %{P} %I %{MD:-MD %{!o:%b.d}%{o*:%.d%*}} %{MMD:-MMD %{!o:%b.d}%{o*:%.d%*}} %{M} %{MM} %{MF*} %{MG} %{MP} %{MQ*} %{MT*} %{!E:%{!M:%{!MM:%{!MT:%{!MQ:%{MD|MMD:%{o*:-MQ %*}}}}}}} %{remap} %{g3|ggdb3|gstabs3|gcoff3|gxcoff3|gvms3:-dD} %{!iplugindir*:%{fplugin*:%:find-plugindir()}} %{H} %C %{D*&U*&A*} %{i*} %Z %i %{fmudflap:-D_MUDFLAP -include mf-runtime.h} %{fmudflapth:-D_MUDFLAP -D_MUDFLAPTH -include mf-runtime.h} %{E|M|MM:%W{o*}} *trad_capable_cpp: cc1 -E %{traditional|traditional-cpp:-traditional-cpp} *cc1: %{!mandroid|tno-android-cc:%(cc1_cpu) %{profile:-p};:%(cc1_cpu) %{profile:-p} %{!mglibc:%{!muclibc:%{!mbionic: -mbionic}}} %{!fno-pic:%{!fno-PIC:%{!fpic:%{!fPIC: -fPIC}}}}} *cc1_options: %{pg:%{fomit-frame-pointer:%e-pg and -fomit-frame-pointer are incompatible}} %{!iplugindir*:%{fplugin*:%:find-plugindir()}} %1 %{!Q:-quiet} %{!dumpbase:-dumpbase %B} %{d*} %{m*} %{aux-info*} %{fcompare-debug-second:%:compare-debug-auxbase-opt(%b)} %{!fcompare-debug-second:%{c|S:%{o*:-auxbase-strip %*}%{!o*:-auxbase %b}}}%{!c:%{!S:-auxbase %b}} %{g*} %{O*} %{W*&pedantic*} %{w} %{std*&ansi&trigraphs} %{v:-version} %{pg:-p} %{p} %{f*} %{undef} %{Qn:-fno-ident} %{Qy:} %{-help:--help} %{-target-help:--target-help} %{-version:--version} %{-help=*:--help=%*} %{!fsyntax-only:%{S:%W{o*}%{!o*:-o %b.s}}} %{fsyntax-only:-o %j} %{-param*} %{fmudflap|fmudflapth:-fno-builtin -fno-merge-constants} %{coverage:-fprofile-arcs -ftest-coverage} *cc1plus: *link_gcc_c_sequence: %{static:--start-group} %G %L %{static:--end-group}%{!static:%G} *link_ssp: %{fstack-protector:} *endfile: %{!mandroid|tno-android-ld:%{Ofast|ffast-math|funsafe-math-optimizations:crtfastmath.o%s} %{mpc32:crtprec32.o%s} %{mpc64:crtprec64.o%s} %{mpc80:crtprec80.o%s} %{shared|pie:crtendS.o%s;:crtend.o%s} crtn.o%s;:%{Ofast|ffast-math|funsafe-math-optimizations:crtfastmath.o%s} %{mpc32:crtprec32.o%s} %{mpc64:crtprec64.o%s} %{mpc80:crtprec80.o%s} %{shared: crtend_so%O%s;: crtend_android%O%s}} *link: %{!r:--build-id} --no-add-needed %{!static:--eh-frame-hdr} --hash-style=gnu %{!mandroid|tno-android-ld:%{m32|mx32:;:-m elf_x86_64} %{m32:-m elf_i386} %{mx32:-m elf32_x86_64} %{shared:-shared} %{!shared: %{!static: %{rdynamic:-export-dynamic} %{m32:-dynamic-linker %{muclibc:/lib/ld-uClibc.so.0;:%{mbionic:/system/bin/linker;:/lib/ld-linux.so.2}}} %{m32|mx32:;:-dynamic-linker %{muclibc:/lib/ld64-uClibc.so.0;:%{mbionic:/system/bin/linker64;:/lib64/ld-linux-x86-64.so.2}}} %{mx32:-dynamic-linker %{muclibc:/lib/ldx32-uClibc.so.0;:%{mbionic:/system/bin/linkerx32;:/libx32/ld-linux-x32.so.2}}}} %{static:-static}};:%{m32|mx32:;:-m elf_x86_64} %{m32:-m elf_i386} %{mx32:-m elf32_x86_64} %{shared:-shared} %{!shared: %{!static: %{rdynamic:-export-dynamic} %{m32:-dynamic-linker %{muclibc:/lib/ld-uClibc.so.0;:%{mbionic:/system/bin/linker;:/lib/ld-linux.so.2}}} %{m32|mx32:;:-dynamic-linker %{muclibc:/lib/ld64-uClibc.so.0;:%{mbionic:/system/bin/linker64;:/lib64/ld-linux-x86-64.so.2}}} %{mx32:-dynamic-linker %{muclibc:/lib/ldx32-uClibc.so.0;:%{mbionic:/system/bin/linkerx32;:/libx32/ld-linux-x32.so.2}}}} %{static:-static}} %{shared: -Bsymbolic}} *lib: %{!mandroid|tno-android-ld:%{pthread:-lpthread} %{shared:-lc} %{!shared:%{mieee-fp:-lieee} %{profile:-lc_p}%{!profile:-lc}};:%{pthread:-lpthread} %{shared:-lc} %{!shared:%{mieee-fp:-lieee} %{profile:-lc_p}%{!profile:-lc}} %{!static: -ldl}} *mfwrap: %{static: %{fmudflap|fmudflapth: --wrap=malloc --wrap=free --wrap=calloc --wrap=realloc --wrap=mmap --wrap=mmap64 --wrap=munmap --wrap=alloca} %{fmudflapth: --wrap=pthread_create}} %{fmudflap|fmudflapth: --wrap=main} *mflib: %{fmudflap|fmudflapth: -export-dynamic} *link_gomp: *libgcc: %{static|static-libgcc:-lgcc -lgcc_eh}%{!static:%{!static-libgcc:%{!shared-libgcc:-lgcc --as-needed -lgcc_s --no-as-needed}%{shared-libgcc:-lgcc_s%{!shared: -lgcc}}}} *startfile: %{!mandroid|tno-android-ld:%{!shared: %{pg|p|profile:gcrt1.o%s;pie:Scrt1.o%s;:crt1.o%s}} crti.o%s %{static:crtbeginT.o%s;shared|pie:crtbeginS.o%s;:crtbegin.o%s};:%{shared: crtbegin_so%O%s;: %{static: crtbegin_static%O%s;: crtbegin_dynamic%O%s}}} *cross_compile: 0 *version: 4.8.5 *multilib: . !m64 !m32;64:../lib64 m64 !m32;32:../lib !m64 m32; *multilib_defaults: m64 *multilib_extra: *multilib_matches: m64 m64;m32 m32; *multilib_exclusions: *multilib_options: m64/m32 *multilib_reuse: *linker: collect2 *linker_plugin_file: *lto_wrapper: *lto_gcc: *link_libgcc: %D *md_exec_prefix: *md_startfile_prefix: *md_startfile_prefix_1: *startfile_prefix_spec: *sysroot_spec: --sysroot=%R *sysroot_suffix_spec: *sysroot_hdrs_suffix_spec: *self_spec: *cc1_cpu: %{march=native:%>march=native %:local_cpu_detect(arch) %{!mtune=*:%>mtune=native %:local_cpu_detect(tune)}} %{mtune=native:%>mtune=native %:local_cpu_detect(tune)} *link_command: %{!fsyntax-only:%{!c:%{!M:%{!MM:%{!E:%{!S: %(linker) %{!fno-use-linker-plugin:%{flto|flto=*|fuse-linker-plugin: -plugin %(linker_plugin_file) -plugin-opt=%(lto_wrapper) -plugin-opt=-fresolution=%u.res %{!nostdlib:%{!nodefaultlibs:%:pass-through-libs(%(link_gcc_c_sequence))}} }}%{flto|flto=*:%<fcompare-debug*} %{flto} %{flto=*} %l %{pie:-pie} %{fuse-ld=*:-fuse-ld=%*} %X %{o*} %{e*} %{N} %{n} %{r} %{s} %{t} %{u*} %{z} %{Z} %{!nostdlib:%{!nostartfiles:%S}} %{static:} %{L*} %(mfwrap) %(link_libgcc) %{!nostdlib:%{!nodefaultlibs:%{fsanitize=address:%{!shared:libasan_preinit%O%s} %{static-libasan:%{!shared:-Bstatic --whole-archive -lasan --no-whole-archive -Bdynamic}}%{!static-libasan:-lasan}} %{fsanitize=thread:%{static-libtsan:%{!shared:-Bstatic --whole-archive -ltsan --no-whole-archive -Bdynamic}}%{!static-libtsan:-ltsan}}}} %o %{fopenmp|ftree-parallelize-loops=*:%:include(libgomp.spec)%(link_gomp)} %{fgnu-tm:%:include(libitm.spec)%(link_itm)} %(mflib) %{fsplit-stack: --wrap=pthread_create} %{fprofile-arcs|fprofile-generate*|coverage:-lgcov} %{!nostdlib:%{!nodefaultlibs:%{fsanitize=address: %{static-libasan:-ldl -lpthread} %{static:%ecannot specify -static with -fsanitize=address} %{fsanitize=thread:%e-fsanitize=address is incompatible with -fsanitize=thread}} %{fsanitize=thread: %{static-libtsan:-ldl -lpthread} %{!pie:%{!shared:%e-fsanitize=thread linking must be done with -pie or -shared}}}}} %{!nostdlib:%{!nodefaultlibs:%(link_ssp) %(link_gcc_c_sequence)}} %{!nostdlib:%{!nostartfiles:%E}} %{T*} }}}}}}信息比较多，定位到关键字 *cc1_options:, 在 %{w} 和 %{std*&ansi&trigraphs} 之间添加 -std=c99：
> cat /usr/lib/gcc/x86_64-redhat-linux/4.8.5/specs.c99 | grep c99 %{pg:%{fomit-frame-pointer:%e-pg and -fomit-frame-pointer are incompatible}} %{!iplugindir*:%{fplugin*:%:find-plugindir()}} %1 %{!Q:-quiet} %{!dumpbase:-dumpbase %B} %{d*} %{m*} %{aux-info*} %{fcompare-debug-second:%:compare-debug-auxbase-opt(%b)} %{!fcompare-debug-second:%{c|S:%{o*:-auxbase-strip %*}%{!o*:-auxbase %b}}}%{!c:%{!S:-auxbase %b}} %{g*} %{O*} %{W*&pedantic*} %{w} -std=c99 %{std*&ansi&trigraphs} %{v:-version} %{pg:-p} %{p} %{f*} %{undef} %{Qn:-fno-ident} %{Qy:} %{-help:--help} %{-target-help:--target-help} %{-version:--version} %{-help=*:--help=%*} %{!fsyntax-only:%{S:%W{o*}%{!o*:-o %b.s}}} %{fsyntax-only:-o %j} %{-param*} %{fmudflap|fmudflapth:-fno-builtin -fno-merge-constants} %{coverage:-fprofile-arcs -ftest-coverage}再次运行 gcc，确认已加载修改后的 spec 文件：
> gcc -v Reading specs from /usr/lib/gcc/x86_64-redhat-linux/4.8.5/specs COLLECT_GCC=gcc COLLECT_LTO_WRAPPER=/usr/libexec/gcc/x86_64-redhat-linux/4.8.5/lto-wrapper Target: x86_64-redhat-linux Configured with: ../configure --prefix=/usr --mandir=/usr/share/man --infodir=/usr/share/info --with-bugurl=http://bugzilla.redhat.com/bugzilla --enable-bootstrap --enable-shared --enable-threads=posix --enable-checking=release --with-system-zlib --enable-__cxa_atexit --disable-libunwind-exceptions --enable-gnu-unique-object --enable-linker-build-id --with-linker-hash-style=gnu --enable-languages=c,c++,objc,obj-c++,java,fortran,ada,go,lto --enable-plugin --enable-initfini-array --disable-libgcj --with-isl=/builddir/build/BUILD/gcc-4.8.5-20150702/obj-x86_64-redhat-linux/isl-install --with-cloog=/builddir/build/BUILD/gcc-4.8.5-20150702/obj-x86_64-redhat-linux/cloog-install --enable-gnu-indirect-function --with-tune=generic --with-arch_32=x86-64 --build=x86_64-redhat-linux Thread model: posix gcc version 4.8.5 20150623 (Red Hat 4.8.5-44) (GCC)第一行的输出符合预期，整个过程可参考附录 4。
如果不进行这个设置，后面在编译 lsp-server 中的 lsp-kind.nvim & nvim-lspconfig 模块时会失败：
glibc
系统提供的 2.17 不行，clangd 需要至少 2.18，否则 neovim 中跳转相关的键 (gd/gD) 会失效，而 yum 上没有大于 2.17 版本的软件可用，需要手动更新下：
# 通过网盘链接下载 rpm 包 # 链接: https://pan.baidu.com/s/1QAyqa04iZ45q1-HqeYH80Q?pwd=1234 提取码: 1234 > ls -lh *.rpm -rw-r--r-- 1 yunhai01 DOORGOD 3.6M May 17 16:28 glibc-2.18-11.fc20.x86_64.rpm -rw-r--r-- 1 yunhai01 DOORGOD 12M May 17 16:28 glibc-common-2.18-11.fc20.x86_64.rpm -rw-r--r-- 1 yunhai01 DOORGOD 1.1M May 17 16:28 glibc-devel-2.18-11.fc20.x86_64.rpm -rw-r--r-- 1 yunhai01 DOORGOD 648K May 17 16:28 glibc-headers-2.18-11.fc20.x86_64.rpm > sudo rpm -Uvh --nodeps --force glibc-*.rpm > ldd --version ldd (GNU libc) 2.18 Copyright (C) 2013 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Written by Roland McGrath and Ulrich Drepper.具体升级过程可参考附录 2。
make
系统提供的 3.82 GNU Make 基本够用。
openssl
系统提供的 1.0.2k 基本够用。
git
系统提供的 1.8 版本不行，需要升级到 2.38，否则不能识别 rebase=false 参数，导致插件更新时拉取代码库失败：
当时直接使用 yum install git 升级的版本还是比较低，所以我是手动安装的，但也取了个巧，直接安装了个 rpm 来更新 CentOS7 的软件源：
> sudo yum install https://packages.endpointdev.com/rhel/7/os/x86_64/endpoint-repo.x86_64.rpm > sudo yum install git > git --version git version 2.38.1从而找到更新版本的 git，省了不少事。后来这个源还更新了，现在安装的话是 2.43 版本。
另外最好更新 /etc/hosts 文件以便加快对 github.com 的访问速度：
> cat /etc/hosts 127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4 ::1 localhost localhost.localdomain localhost6 localhost6.localdomain6 140.82.114.3 github.com 140.82.114.10 nodeload.github.com 140.82.114.6 api.github.com 140.82.114.10 codeload.github.com这里的 ip 都是通过反查相关域名得到的，可能会有所不同，详情参考附录 3。
wget
系统提供的 1.14 版本不行，在拉取部分 lsp-server 时会出错 (cpp/lua)，需要升级到 1.21.3：
> curl -o wget-latest.tar.gz http://mirrors.ustc.edu.cn/gnu/wget/wget-latest.tar.gz > tar xvf wget-latest.tar.gz > cd wget-1.21.3 > ./configure --with-ssl=openssl > make -j8 > sudo make install > wget --version GNU Wget 1.21.3 built on linux-gnu. -cares +digest -gpgme +https +ipv6 -iri +large-file -metalink +nls +ntlm +opie -psl +ssl/openssl Wgetrc: /usr/local/etc/wgetrc (system) Locale: /usr/local/share/locale Compile: gcc -std=gnu11 -DHAVE_CONFIG_H -DSYSTEM_WGETRC="/usr/local/etc/wgetrc" -DLOCALEDIR="/usr/local/share/locale" -I. -I../lib -I../lib -DHAVE_LIBSSL -DNDEBUG -g -O2 Link: gcc -std=gnu11 -DHAVE_LIBSSL -DNDEBUG -g -O2 -lpcre -lssl -lcrypto -lz ../lib/libgnu.a Copyright (C) 2015 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://www.gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. Originally written by Hrvoje Niksic <hniksic@xemacs.org>. Please send bug reports and questions to <bug-wget@gnu.org>.目前的 wget-lastest 指向的最新版本是 1.24.5。
python3
系统提供的 3.6.8 版本勉强够用，clang-format 编译安装要求 python 至少为 3.8 版本，可以选择安装 Python 3.8.1：
> sudo yum install libffi-devel > wget https://www.python.org/ftp/python/3.8.1/Python-3.8.1.tgz > tar -xvf Python-3.8.1.tgz > cd Python-3.8.1 > ./configure --prefix=/usr/local/python3 > make -j8 > sudo make altinstall > sudo ln -sf /usr/local/python3/bin/python3.8 /usr/bin/python3 > sudo ln -sf /usr/local/python3/bin/pip3.8 /usr/bin/pip3不过可以通过直接下载 clang-format 来忽略这步，所以这里的 python3 没有升级，具体操作步骤在安装 clang-format 时介绍。
cargo
rust 的包管理器，系统未提供，需要单独安装：
> sudo yum install cargo > cargo --version cargo 1.65.0用于后续安装 fd，它是一款 find 的替代者，可以实现更高效的文件查找，目前 yum 上最新的版本是 1.72.1。
go
go 语言编译器，系统未提供，需要单独安装：
> sudo yum install go > go version go version go1.17.12 linux/amd64用来后续编译安装 efm-langserver，它是一款代码审查工具。目前 yum 源最新 go 版本是 1.20.12。为避免后续安装过程中出现网络访问错误的问题，可提前设置以下代理：
> go env -w GO111MODULE=on > go env -w GOPROXY=https://goproxy.io,direct > go env -w GOPRIVATE=*.corp.example.comsqlite3
本地数据库，系统未提供，需要单独安装：
> sudo yum install sqlite sqlite-devel > sqlite3 --version 3.7.17 2013-05-20 00:56:22 118a3b35693b134d56ebd780123b7fd6f1497668用于后续安装 scheme ，它是一款语法高亮插件，使用 sqlite3 存储信息。
升级后
- gcc：4.8.5
- glibc：2.18
- make：GNU make 3.82
- openssl：1.0.2k
- git：2.43
- wget：1.24.5
- python: 3.6.8
- cargo：1.72.1
- go：1.20.12
- sqlite3：3.7.17
依赖软件安装
rg
全名 ripgrep，是 grep 替代者，功能更强大，不能直接使用 yum 安装，通过添加 yum 源的方式来曲线安装：
> sudo yum-config-manager --add-repo=https://copr.fedorainfracloud.org/coprs/carlwgeorge/ripgrep/repo/epel-7/carlwgeorge-ripgrep-epel-7.repo > sudo yum install ripgrep > rg --version ripgrep 13.0.0 -SIMD -AVX (compiled) +SIMD +AVX (runtime)源是固定的，版本目前仍保持 13.0.0。
fd
全名 fd-find，用来替代 find，功能更强大，有之前安装 cargo 的基础，直接安装：
> cargo install fd-find > sudo cp ~/.cargo/bin/fd /usr/local/bin/ > fd --version fd 8.5.3基于最新的 cargo 1.72.1 安装会报错：
> cargo install fd-find Updating crates.io index Downloaded fd-find v10.1.0 ... warning: spurious network error (3 tries remaining): [7] Couldn't connect to server (Failed to connect to 2a04:4e42:8c::649: Network is unreachable) Downloaded jemalloc-sys v0.5.4+5.3.0-patched Downloaded 64 crates (8.2 MB) in 3m 10s (largest was `linux-raw-sys` at 1.8 MB) error: failed to compile `fd-find v10.1.0`, intermediate artifacts can be found at `/tmp/cargo-installBfI2hZ`. To reuse those artifacts with a future compilation, set the environment variable `CARGO_TARGET_DIR` to that path. Caused by: package `clap_complete v4.5.2` cannot be built because it requires rustc 1.74 or newer, while the currently active rustc version is 1.72.1 Try re-running cargo install with `--locked`看起来需要升级 rustc (1.74 > 1.72.1)，不过看到要安装的 fd-find 版本为 10.1.0，好像受到了启发，直接指定 fd-find 的版本为 8.5.3 重试：
> cargo install fd-find --version 8.5.3 Downloaded fd-find v8.5.3 Downloaded 1 crate (114.1 KB) in 9.31s Updating crates.io index Installing fd-find v8.5.3 Updating crates.io index ... Downloaded 22 crates (2.2 MB) in 1m 07s (largest was `linux-raw-sys` at 1013.8 KB) error: failed to compile `fd-find v8.5.3`, intermediate artifacts can be found at `/tmp/cargo-installmg1If6`. To reuse those artifacts with a future compilation, set the environment variable `CARGO_TARGET_DIR` to that path. Caused by: package `clap_complete v4.5.2` cannot be built because it requires rustc 1.74 or newer, while the currently active rustc version is 1.72.1 Try re-running cargo install with `--locked`仍然失败，叔可忍婶不可忍，直接按提示加 --locked 选项：
查看代码
> cargo install fd-find --version 8.5.3 --locked Updating crates.io index Installing fd-find v8.5.3 Updating crates.io index warning: spurious network error (3 tries remaining): [7] Couldn't connect to server (Failed to connect to 2600:9000:20e4:fe00:1f:a9f5:69c0:93a1: Network is unreachable) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation timed out after 30000 milliseconds with 0 out of 0 bytes received) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation too slow. Less than 10 bytes/sec transferred the last 30 seconds) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation too slow. Less than 10 bytes/sec transferred the last 30 seconds) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation too slow. Less than 10 bytes/sec transferred the last 30 seconds) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation too slow. Less than 10 bytes/sec transferred the last 30 seconds) warning: package `crossbeam-channel v0.5.6` in Cargo.lock is yanked in registry `crates-io`, consider running without --locked Updating crates.io index warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation timed out after 30000 milliseconds with 0 out of 0 bytes received) Downloaded ctrlc v3.2.3 Downloaded termcolor v1.1.3 Downloaded crossbeam-utils v0.8.12 Downloaded time v0.1.44 Downloaded clap_complete v4.0.5 Downloaded clap_derive v4.0.21 Downloaded num-traits v0.2.15 Downloaded thread_local v1.1.4 Downloaded proc-macro2 v1.0.47 Downloaded memchr v2.5.0 Downloaded jemallocator v0.5.0 Downloaded iana-time-zone v0.1.51 Downloaded os_str_bytes v6.3.0 Downloaded unicode-ident v1.0.5 Downloaded globset v0.4.9 Downloaded heck v0.4.0 Downloaded clap v4.0.22 Downloaded num-integer v0.1.45 Downloaded proc-macro-error v1.0.4 Downloaded quote v1.0.21 Downloaded fs_extra v1.2.0 Downloaded anyhow v1.0.66 Downloaded fnv v1.0.7 Downloaded nix v0.24.2 Downloaded terminal_size v0.2.1 Downloaded clap_lex v0.3.0 Downloaded ignore v0.4.18 Downloaded proc-macro-error-attr v1.0.4 Downloaded io-lifetimes v0.7.4 Downloaded log v0.4.17 Downloaded regex v1.6.0 Downloaded cc v1.0.73 Downloaded once_cell v1.15.0 Downloaded num_cpus v1.13.1 Downloaded syn v1.0.103 Downloaded rustix v0.35.12 Downloaded nix v0.25.0 Downloaded autocfg v1.1.0 Downloaded crossbeam-channel v0.5.6 Downloaded regex-syntax v0.6.27 Downloaded bstr v0.2.17 Downloaded chrono v0.4.22 Downloaded linux-raw-sys v0.0.46 warning: spurious network error (3 tries remaining): [7] Couldn't connect to server (Failed to connect to 2a04:4e42:8c::649: Network is unreachable) Downloaded walkdir v2.3.2 Downloaded jemalloc-sys v0.5.2+5.3.0-patched Downloaded aho-corasick v0.7.19 warning: spurious network error (3 tries remaining): [28] Timeout was reached (download of `libc v0.2.136` failed to transfer more than 10 bytes in 30s) Downloaded libc v0.2.136 Downloaded 47 crates (5.7 MB) in 3m 17s Compiling libc v0.2.136 Compiling cfg-if v1.0.0 Compiling version_check v0.9.4 Compiling proc-macro2 v1.0.47 Compiling unicode-ident v1.0.5 Compiling bitflags v1.3.2 Compiling quote v1.0.21 Compiling autocfg v1.1.0 Compiling memchr v2.5.0 Compiling proc-macro-error-attr v1.0.4 Compiling io-lifetimes v0.7.4 Compiling syn v1.0.103 Compiling proc-macro-error v1.0.4 Compiling log v0.4.17 Compiling rustix v0.35.12 Compiling num-traits v0.2.15 Compiling crossbeam-utils v0.8.12 Compiling cc v1.0.73 Compiling fs_extra v1.2.0 Compiling once_cell v1.15.0 Compiling linux-raw-sys v0.0.46 Compiling jemalloc-sys v0.5.2+5.3.0-patched Compiling aho-corasick v0.7.19 Compiling num-integer v0.1.45 Compiling os_str_bytes v6.3.0 Compiling regex-syntax v0.6.27 Compiling heck v0.4.0 Compiling clap_derive v4.0.21 Compiling regex v1.6.0 Compiling clap_lex v0.3.0 Compiling terminal_size v0.2.1 Compiling bstr v0.2.17 Compiling atty v0.2.14 Compiling lazy_static v1.4.0 Compiling strsim v0.10.0 Compiling same-file v1.0.6 Compiling fnv v1.0.7 Compiling termcolor v1.1.3 Compiling anyhow v1.0.66 Compiling clap v4.0.22 Compiling globset v0.4.9 Compiling walkdir v2.3.2 Compiling thread_local v1.1.4 Compiling nix v0.25.0 Compiling nix v0.24.2 Compiling dirs-sys-next v0.1.2 Compiling time v0.1.44 Compiling fd-find v8.5.3 Compiling ansi_term v0.12.1 Compiling iana-time-zone v0.1.51 Compiling chrono v0.4.22 Compiling lscolors v0.12.0 Compiling dirs-next v2.0.0 Compiling argmax v0.3.1 Compiling ctrlc v3.2.3 Compiling ignore v0.4.18 Compiling clap_complete v4.0.5 Compiling jemallocator v0.5.0 Compiling crossbeam-channel v0.5.6 Compiling users v0.11.0 Compiling num_cpus v1.13.1 Compiling humantime v2.1.0 Compiling normpath v0.3.2 Finished release [optimized] target(s) in 10m 44s warning: the following packages contain code that will be rejected by a future version of Rust: fs_extra v1.2.0 note: to see what the problems were, use the option `--future-incompat-report`, or run `cargo report future-incompatibilities --id 1` Installing /home/users/yunhai01/.cargo/bin/fd Installed package `fd-find v8.5.3` (executable `fd`) warning: be sure to add `/home/users/yunhai01/.cargo/bin` to your PATH to be able to run the installed binaries这回成功了。尝试为之前安装失败的 10.1.0 版本增加 --locked 选项：
> cargo install fd-find --locked Updating crates.io index Installing fd-find v10.1.0 Updating crates.io index warning: package `libc v0.2.154` in Cargo.lock is yanked in registry `crates-io`, consider running without --locked Updating crates.io index Downloaded proc-macro2 v1.0.81 Downloaded anyhow v1.0.82 Downloaded serde v1.0.200 Downloaded errno v0.3.8 Downloaded cc v1.0.96 Downloaded syn v2.0.60 Downloaded libc v0.2.154 Downloaded linux-raw-sys v0.4.13 Downloaded 8 crates (2.8 MB) in 1m 27s (largest was `linux-raw-sys` at 1.5 MB) error: failed to compile `fd-find v10.1.0`, intermediate artifacts can be found at `/tmp/cargo-installVoh51U`. To reuse those artifacts with a future compilation, set the environment variable `CARGO_TARGET_DIR` to that path. Caused by: package `clap_builder v4.5.2` cannot be built because it requires rustc 1.74 or newer, while the currently active rustc version is 1.72.1仍然不行，看来回退 8.5.3 是唯一的解决办法。之前还探索过将 cargo 版本降为 1.65.0：
> sudo yum remove cargo > sudo yum install cargo-1.65.0-1.el7.x86_64 Loaded plugins: fastestmirror, langpacks, versionlock Loading mirror speeds from cached hostfile Excluding 1 update due to versionlock (use "yum versionlock status" to show it) No package cargo-1.65.0-1.el7.x86_64 available. Error: Nothing to do未能成功。在网上也没搜到 1.65.0 的 cargo rpm 包，只能作罢。不清楚为何 1.72.1 的 cargo 要求 1.74 的 rustc，严重怀疑这是一个 bug。
书归正题，在安装完 fd 8.5.3 后需要按提示将 fd 移到 /usr/loca/bin：
> sudo cp /home/users/yunhai01/.cargo/bin/fd /usr/local/bin/ > fd --version fd 8.5.3否则 neovim 找不到。
tree-sitter
是一个解析器生成工具和增量解析库，在 nvim 中主要用作 latex 语言解析器、以及 rainbow-delimiters.nvim 和 nvim-treesitter.nvim 插件的底层支持。rainbow-delimiters 主要用于多种语言的语法高亮，特别是多括号的展示；nvim-treesitter 主要用于高效代码导航与编辑，是 IDE 不可或缺的底层组件。
可以使用 cargo 安装：
> cargo install tree-sitter-cli会遇到和安装 fd 类似的问题：
查看代码
> cargo install tree-sitter-cli Updating crates.io index Installing tree-sitter-cli v0.22.6 Updating crates.io index warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation timed out after 30001 milliseconds with 0 out of 0 bytes received) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation timed out after 30000 milliseconds with 0 out of 0 bytes received) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation too slow. Less than 10 bytes/sec transferred the last 30 seconds) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation too slow. Less than 10 bytes/sec transferred the last 30 seconds) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation timed out after 30001 milliseconds with 0 out of 0 bytes received) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation too slow. Less than 10 bytes/sec transferred the last 30 seconds) warning: spurious network error (3 tries remaining): [28] Timeout was reached (Operation too slow. Less than 10 bytes/sec transferred the last 30 seconds) Downloaded httpdate v1.0.3 Downloaded equivalent v1.0.1 Downloaded tiny_http v0.12.0 Downloaded anstyle-query v1.1.0 Downloaded ascii v1.1.0 Downloaded dirs-sys v0.4.1 Downloaded serde_derive v1.0.203 Downloaded tempfile v3.10.1 Downloaded clap_builder v4.5.6 Downloaded webbrowser v1.0.1 Downloaded tree-sitter-config v0.22.6 Downloaded tree-sitter-tags v0.22.6 Downloaded proc-macro2 v1.0.85 Downloaded percent-encoding v2.3.1 Downloaded unicode-normalization v0.1.23 Downloaded semver v1.0.23 Downloaded libloading v0.8.3 Downloaded filetime v0.2.23 Downloaded idna v0.5.0 Downloaded ahash v0.8.11 Downloaded itoa v1.0.11 Downloaded form_urlencoded v1.2.1 Downloaded zerocopy v0.7.34 Downloaded wasmparser v0.206.0 Downloaded option-ext v0.2.0 Downloaded dirs v5.0.1 Downloaded serde_json v1.0.117 Downloaded chunked_transfer v1.5.0 Downloaded ryu v1.0.18 Downloaded tree-sitter v0.22.6 warning: spurious network error (3 tries remaining): [35] SSL connect error (TCP connection reset by peer) Downloaded thiserror-impl v1.0.61 Downloaded clap_lex v0.7.1 Downloaded serde v1.0.203 Downloaded unicode-bidi v0.3.15 Downloaded glob v0.3.1 Downloaded tree-sitter-loader v0.22.6 Downloaded indexmap v2.2.6 Downloaded fastrand v2.1.0 Downloaded url v2.5.0 Downloaded indoc v2.0.5 Downloaded tinyvec_macros v0.1.1 Downloaded rustc-hash v1.1.0 Downloaded clap v4.5.6 Downloaded html-escape v0.2.13 Downloaded clap_derive v4.5.5 Downloaded tree-sitter-highlight v0.22.6 Downloaded fs4 v0.8.3 warning: spurious network error (3 tries remaining): [28] Timeout was reached (download of `difference v2.0.0` failed to transfer more than 10 bytes in 30s) Downloaded difference v2.0.0 warning: spurious network error (3 tries remaining): [7] Couldn't connect to server (Failed to connect to 2a04:4e42:1a::649: Network is unreachable) Downloaded utf8-width v0.1.7 warning: spurious network error (3 tries remaining): [28] Timeout was reached (download of `hashbrown v0.14.5` failed to transfer more than 10 bytes in 30s) Downloaded hashbrown v0.14.5 warning: spurious network error (3 tries remaining): [28] Timeout was reached (download of `smallbitvec v2.5.3` failed to transfer more than 10 bytes in 30s) Downloaded smallbitvec v2.5.3 warning: spurious network error (3 tries remaining): [28] Timeout was reached (download of `thiserror v1.0.61` failed to transfer more than 10 bytes in 30s) Downloaded thiserror v1.0.61 warning: spurious network error (3 tries remaining): [28] Timeout was reached (download of `tinyvec v1.6.0` failed to transfer more than 10 bytes in 30s) Downloaded tinyvec v1.6.0 Downloaded 53 crates (2.7 MB) in 4m 35s error: failed to compile `tree-sitter-cli v0.22.6`, intermediate artifacts can be found at `/tmp/cargo-installFBNfkt`. To reuse those artifacts with a future compilation, set the environment variable `CARGO_TARGET_DIR` to that path. Caused by: package `tree-sitter-highlight v0.22.6` cannot be built because it requires rustc 1.74.1 or newer, while the currently active rustc version is 1.72.1 Try re-running cargo install with `--locked`增加 --locked 选项应该可以解决问题，使用 cargo 1.72.1 目前安装的版本为 0.22.6，这个版本运行依赖较高的 glibc，所以放弃。
通过官方提示的 npm 方式安装的结果也差不多：
> npm install tree-sitter-cli added 1 package in 10m > ls -lh node_modules/tree-sitter-cli/ total 25M -rwxr-xr-x 1 yunhai01 DOORGOD 303 Jun 7 12:13 cli.js -rw-r--r-- 1 yunhai01 DOORGOD 14K Jun 7 12:13 dsl.d.ts -rwxr-xr-x 1 yunhai01 DOORGOD 3.4K Jun 7 12:13 install.js -rw-r--r-- 1 yunhai01 DOORGOD 1.1K Jun 7 12:13 LICENSE -rw-r--r-- 1 yunhai01 DOORGOD 534 Jun 7 12:13 package.json -rw-r--r-- 1 yunhai01 DOORGOD 1.7K Jun 7 12:13 README.md -rwxr-xr-x 1 yunhai01 DOORGOD 25M Jun 7 12:23 tree-sitter > node_modules/tree-sitter-cli/tree-sitter --version node_modules/tree-sitter-cli/tree-sitter: /lib64/libc.so.6: version `GLIBC_2.25' not found (required by node_modules/tree-sitter-cli/tree-sitter) node_modules/tree-sitter-cli/tree-sitter: /lib64/libc.so.6: version `GLIBC_2.29' not found (required by node_modules/tree-sitter-cli/tree-sitter) node_modules/tree-sitter-cli/tree-sitter: /lib64/libc.so.6: version `GLIBC_2.28' not found (required by node_modules/tree-sitter-cli/tree-sitter)最早之前安装的 0.20.7 版本是 ok 的，想通过这种方式安装的朋友，可以指定版本试一下。注意这两种方式安装后的文件分别位于 ~/.cargo/bin 和 ./node_modules/tree-sitter-cli 下，需要手动复制到 /usr/local/bin 以便生效。
现在介绍第三种安装方式，不依赖 cargo、npm 等包管理器，直接定位到 tree-sitter 官方下载页面，选择 0.20.4 版本，对于我的 CentOS7 x64 版本，选择 tree-sitter-linux-x64.gz 下载即可：
> gunzip tree-sitter-linux-x64.gz > chmod u+x tree-sitter-linux-x64 > sudo mv tree-sitter-linux-x64 /usr/local/bin > tree-sitter --version tree-sitter 0.20.4 (714bfd47a744ab44b904375c177a24c0614ef49c)按上一面一步步执行就安装好了，亲测高于 0.20.4 的版本就有 glibc 兼容问题 (>2.18)。
efm-langserver
实现智能 IDE 的核心，基于 go 语言开发，使用 go 编译安装：
> go install github.com/mattn/efm-langserver@latest安装后没有找到 efm-langserver，经查，go 1.20 之后，需要通过 GOPATH 环境变量来指定安装目录：
> export GOPATH=/ext/tools > go install github.com/mattn/efm-langserver@latest go: downloading github.com/mattn/efm-langserver v0.0.53 go: downloading github.com/sourcegraph/jsonrpc2 v0.2.0 go: downloading gopkg.in/yaml.v3 v3.0.1 go: downloading github.com/mattn/go-unicodeclass v0.0.2 go: downloading github.com/reviewdog/errorformat v0.0.0-20240311054359-739e471a49b3同样需要复制到 /usr/local/bin 目录以便全局生效：
> sudo cp bin/efm-langserver /usr/local/bin > efm-langserver -v efm-langserver 0.0.53 (rev: HEAD/go1.20.12)比之前安装的版本略高一些：
> efm-langserver -v efm-langserver 0.0.44 (rev: 36a4d81/go1.17.12)Font
下载可支持符号的字体，例如：Nerd Font，在 macOS 上的安装非常简单，直接双击 ttf 文件安装：
然后在 macOS 终端上指定该字体，这里我使用的是 iTerm2，其它终端大同小异：
iTerm2 有以下 UI 路径：iTerm2 -> settings -> Profiles -> Default -> Text -> Font。下面是安装带符号字体前后的对比：
状态栏很多不能显示的符号都正常了 (标签页的仍保持问号，可能是一个特殊符号 Nerd Font 不支持)。
neovim
IDE 的载体，不使用 yum 安装，原因是 yum 上目前只有 0.3 版本的 neovim，而支持现代化 IDE 核心的 packer 包管理器至少需要 0.7 版本。这里使用 curl 直接下载最新版本：
> curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim.appimage启动：
> chmod u+x nvim.appimage > ./nvim.appimage报错：
/tmp/.mount_nvim.aw3KspQ/usr/bin/nvim: /lib64/libc.so.6: version `GLIBC_2.28' not found (required by /tmp/.mount_nvim.aw3KspQ/usr/bin/nvim) /tmp/.mount_nvim.aw3KspQ/usr/bin/nvim: /lib64/libm.so.6: version `GLIBC_2.29' not found (required by /tmp/.mount_nvim.aw3KspQ/usr/bin/nvim)看起来需要升级 glibc 2.29，为了避免再次更新 glibc，这里直接选择可以成功安装的 neovim 0.9.2 版本：
> wget https://github.com/neovim/neovim/releases/download/v0.9.2/nvim.appimage友情提示：可以在 web 端下载后传递给虚拟机，macOS 访问 github 要比虚拟机快许多。
下载成功后，运行 nvim.appimage 可以自动释放目标文件：
> chmod u+x nvim.appimage > ./nvim.appimage如果运行后没有产生 squashfs-root 目录，说明系统缺乏 FUSE (用户空间文件系统)，需要手动释放一下：
> ./nvim.appimage --appimage-extract设置到 /usr/local/bin 后就可以被全局引用了：
> sudo ln -s $PWD/squashfs-root/AppRun /usr/local/bin/nvim > nvim --version NVIM v0.9.2 Build type: Release LuaJIT 2.1.1692716794 system vimrc file: "$VIM/sysinit.vim" fall-back for $VIM: "/__w/neovim/neovim/build/nvim.AppDir/usr/share/nvim" Run :checkhealth for more infonvimdots
IDE 的实现，按照 github 主页 README 的说明直接安装：
if command -v curl >/dev/null 2>&1; then bash -c "$(curl -fsSL https://raw.githubusercontent.com/ayamir/nvimdots/HEAD/scripts/install.sh)" else bash -c "$(wget -O- https://raw.githubusercontent.com/ayamir/nvimdots/HEAD/scripts/install.sh)" fi脚本会自动判断 neovim 版本并进行适配：
> bash -c "$(wget -O- https://raw.githubusercontent.com/ayamir/nvimdots/HEAD/scripts/install.sh)" --2024-05-24 15:32:21-- https://raw.githubusercontent.com/ayamir/nvimdots/HEAD/scripts/install.sh Resolving raw.githubusercontent.com... 185.199.108.133, 185.199.109.133, 185.199.111.133, ... Connecting to raw.githubusercontent.com|185.199.108.133|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 7830 (7.6K) [text/plain] Saving to: ‘STDOUT’ - 100%[======================================================================================================>] 7.65K 6.79KB/s in 1.1s 2024-05-24 15:32:25 (6.79 KB/s) - written to stdout [7830/7830] ==> This script will install ayamir/nvimdots to: /home/users/yunhai01/.config/nvim Press RETURN/ENTER to continue or any other key to abort... ==> Validating SSH connection... Do you prefer to use SSH to fetch and update plugins? (otherwise HTTPS) [Y/n]: ==> Checking 'git clone' preferences... Would you like to perform a shallow clone ('--depth=1')? [Y/n]: ==> Fetching in progress... Cloning into '/home/users/yunhai01/.config/nvim'... remote: Enumerating objects: 170, done. remote: Counting objects: 100% (170/170), done. remote: Compressing objects: 100% (162/162), done. remote: Total 170 (delta 5), reused 73 (delta 0), pack-reused 0 Receiving objects: 100% (170/170), 108.87 KiB | 203.00 KiB/s, done. Resolving deltas: 100% (5/5), done. ==> Spawning Neovim and fetching plugins... (You'll be redirected shortly) ==> NOTE: Please make sure you have a Rust Toolchain installed via `rustup`! Otherwise, unexpected things may happen. See: https://www.rust-lang.org/tools/install. ==> If lazy.nvim failed to fetch any plugin(s), maunally execute `:Lazy sync` until everything is up-to-date. Thank you for using this set of configuration! - Project Homepage: https://github.com/ayamir/nvimdots - Further documentation (including executables you must install for full functionality): https://github.com/ayamir/nvimdots/wiki/Prerequisites Press RETURN/ENTER to continue or any other key to abort...执行过程中会让用户进行若干选项，都按默认处理就可以了。到这里所有必需软件就都安装完成了，按任意键将进入插件的安装，具体内容在下一节介绍。
安装后的目录位于：~/.config/nvim/。注意这里不要选择 neovim 0.8.1 (说的就是我)，否则后面启动插件管理器时会报错：
Error executing Lua callback: ...l/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/float.lua:159: Vim(append):Error executing lua callback: ...zy/rainbow-delimiters.nvim/plugin/rainbow-delimiter s.lua:50: attempt to call field 'get_lang' (a nil value) stack traceback: ...zy/rainbow-delimiters.nvim/plugin/rainbow-delimiters.lua:50: in function 'attach' ...zy/rainbow-delimiters.nvim/plugin/rainbow-delimiters.lua:151: in function <...zy/rainbow-delimiters.nvim/plugin/rainbow-delimiters.lua:151> [C]: in function '__newindex' ...l/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/float.lua:159: in function 'mount' ...l/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/float.lua:75: in function 'init' ...al/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/init.lua:53: in function 'create' ...al/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/init.lua:38: in function 'show' ...hare/nvim/site/lazy/lazy.nvim/lua/lazy/view/commands.lua:38: in function 'command' ...hare/nvim/site/lazy/lazy.nvim/lua/lazy/view/commands.lua:24: in function 'cmd' ...hare/nvim/site/lazy/lazy.nvim/lua/lazy/view/commands.lua:111: in function <...hare/nvim/site/lazy/lazy.nvim/lua/lazy/view/commands.lua:98> stack traceback: [C]: in function '__newindex' ...l/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/float.lua:159: in function 'mount' ...l/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/float.lua:75: in function 'init' ...al/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/init.lua:53: in function 'create' ...al/share/nvim/site/lazy/lazy.nvim/lua/lazy/view/init.lua:38: in function 'show' ...hare/nvim/site/lazy/lazy.nvim/lua/lazy/view/commands.lua:38: in function 'command' ...hare/nvim/site/lazy/lazy.nvim/lua/lazy/view/commands.lua:24: in function 'cmd' ...hare/nvim/site/lazy/lazy.nvim/lua/lazy/view/commands.lua:111: in function <...hare/nvim/site/lazy/lazy.nvim/lua/lazy/view/commands.lua:98>基本无解。
开发环境搭建
框架好比是毛坯房，想要入住还得“精装修”一下，主要是安装各种插件，以及本地化配置。
插件安装
同许多 IDE 一样，vim 很多功能是通过插件实现的，插件本身需要管理，这就催生了形形色色的插件管理器，知名的有 vim-plug、Vundle；vim 进化到 neovim 之后，有两个主要的插件管理器，一个是 packer，另一个是 lazy，两个都很好用，之前 nvimdots 使用的 packer，后来更新到了 lazy，可以有效的提升 neovim 的启动速度。
lazy
书接上节，在 nvimdots 安装结束后，按任意键将启动 nvim、自动拉起插件更新：
这个界面静静等待即可，最终都能安装成功：
在 lazy 插件管理页面，输入标签后面的字符可实现跳转，例如 U 跳转到更新插件页面。
也可以直接在命令行输入 :Lazy sync 来切换到 Sync 标签：
其它也类似，不再赘述。当所有插件安装结束后，q 退出界面。与原先的 packer 界面相比：
简直像从远古社会跨进到了现代社会。退出 lazy、退出 nvim，插件安装路径位于：~/.local/share/nvim 目录下。再次进入 nvim，将看到欢迎界面：
基本功能已经可用，有几个未安装的插件将继续安装。
mason
mason 也是一个插件管理器，聚焦于 lsp 服务、dap 服务、linter 和 formatter 方向，通过它可以让 nvim 轻松支持多种编程语言的智能化展示。通过 :Mason 启动：
可以观察到系统可用的语言插件、安装成功的、安装失败的，这里主要需要处理 2 个插件的安装。
clangd
从上面的日志可以看出，安装失败的原因主要是从网络获取 clangd 包失败，这里改为手动下载：
> wget https://github.com/clangd/clangd/releases/download/18.1.3/clangd-linux-18.1.3.zip > mv clangd-linux-18.1.3.zip ~/.local/share/nvim/mason/packages > cd ~/.local/share/nvim/mason/packages > unzip clangd-linux-18.1.3.zip > cd ../bin > ln -s $PWD/../packages/clangd_18.1.3/bin/clangd clangd > ./clangd --version clangd version 18.1.3 (https://github.com/llvm/llvm-project c13b7485b87909fcf739f62cfa382b55407433c0) Features: linux+grpc Platform: x86_64-unknown-linux-gnu解压并替换到目标目录、设置命令软链接后，重启 nvim 查看：
安装成功，如果 nvim 仍显示安装 clangd，就多重启几次，甚至重启下机器。
clang-format
查看 clang-format 错误日志：
没看出来安装失败的直接原因，这里改为手动下载：
> wget -c https://github.com/muttleyxd/clang-tools-static-binaries/releases/download/master-1d7ec53d/clang-format-10_linux-amd64 > chmod u+x clang-format-10_linux-arm64 > mkdir -p ~/.local/share/nvim/mason/packages/clang-format/bin > mv clang-format-10_linux-amd64 ~/.local/share/nvim/mason/packages/clang-format/bin > cd ~/.local/share/nvim/mason/bin > ln -s $PWD/../packages/clang-format/bin/clang-format-10_linux-amd64 clang-format > ./clang-format --version clang-format version 10.0.1替换到目标目录、设置命令软链接后，重启 nvim 查看：
安装成功。如果想让 Mason 安装 clang-format，除了之前介绍的升级 python3 步骤外，还需要以下操作：
> sudo pip3 install wheel # 进入 nvim MasonInstall clang-format最后还有两个插件 python-lsp-server & gopls 没安装成功，分别是 python 与 go 语言 lspserver，由于本文着重介绍 C/C++ 环境的搭建，这个偏离主题就不再赘述了，有需求的小伙伴可以在 nvimdots 中提问寻求帮助。
如果不想看到每次在启动时它们的报错信息，可以选择不加载它们，具体操作步骤详见配置一节。
配置
各种功能插件安装完成后，还需要修改化配置一番，为了方便调用 neovim，在 bash 启动脚本中增加以下内容：
alias vi=nvim alias vim=nvim这样就可以使用 vi 或 vim 代替 nvim 了，相当于替换了默认的 vim 编辑器，如果想调用原始的 vim 编辑器，需要输入完整路径：
> /usr/bin/vi在进行配置之前，首先对 nvim 进行一次自我体验，这主要是通过 :checkhealth 命令来完成，下面是完整的 checkhealth 输出：
查看代码
============================================================================== hop: require("hop.health").check() Ensuring keys are unique ~ - OK Keys are unique Checking for deprecated features ~ - OK All good ============================================================================== lazy: require("lazy.health").check() lazy.nvim ~ - OK Git installed - OK no existing packages found by other package managers - OK packer_compiled.lua not found ============================================================================== lspsaga: require("lspsaga.health").check() Lspsaga.nvim report ~ - OK `tree-sitter` found - OK tree-sitter `markdown` parser found - OK tree-sitter `markdown_inline` parser found ============================================================================== luasnip: require("luasnip.health").check() luasnip ~ - WARNING For Variable/Placeholder-transformations, luasnip requires the jsregexp library. See `:help |luasnip-lsp-snippets-transformations`| for advice ============================================================================== mason: require("mason.health").check() mason.nvim ~ - OK mason.nvim version v1.10.0 - OK PATH: prepend - OK Providers: mason.providers.registry-api mason.providers.client - OK neovim version >= 0.7.0 mason.nvim [Registries] ~ - OK Registry `github.com/mason-org/mason-registry version: 2024-06-07-fast-test` is installed. mason.nvim [Core utils] ~ - OK unzip: `UnZip 6.00 of 20 April 2009, by Info-ZIP. Maintained by C. Spieler. Send` - OK wget: `GNU Wget 1.24.5 built on linux-gnu.` - OK curl: `curl 7.87.0 (x86_64-pc-linux-muslx32) libcurl/7.87.0 OpenSSL/1.1.1s zlib/1.2.12 libssh2/1.9.0 nghttp2/1.43.0` - OK gzip: `gzip 1.5` - OK gtar: `tar (GNU tar) 1.26` - OK bash: `GNU bash, version 4.2.46(2)-release (x86_64-redhat-linux-gnu)` - OK sh: `Ok` mason.nvim [Languages] ~ - WARNING luarocks: not available - ADVICE: - spawn: luarocks failed with exit code - and signal -. luarocks is not executable - WARNING Ruby: not available - ADVICE: - spawn: ruby failed with exit code - and signal -. ruby is not executable - WARNING RubyGem: not available - ADVICE: - spawn: gem failed with exit code - and signal -. gem is not executable - WARNING Composer: not available - ADVICE: - spawn: composer failed with exit code - and signal -. composer is not executable - WARNING PHP: not available - ADVICE: - spawn: php failed with exit code - and signal -. php is not executable - OK node: `v16.18.1` - OK cargo: `cargo 1.72.1` - WARNING julia: not available - ADVICE: - spawn: julia failed with exit code - and signal -. julia is not executable - OK Go: `go version go1.20.12 linux/amd64` - OK python: `Python 3.6.8` - OK java: `openjdk version "1.8.0_322"` - OK pip: `pip 9.0.3 from /usr/lib/python3.6/site-packages (python 3.6)` - OK python venv: `Ok` - OK javac: `Ok` - OK npm: `8.19.2` mason.nvim [GitHub] ~ - OK GitHub API rate limit. Used: 1. Remaining: 59. Limit: 60. Reset: Fri 07 Jun 2024 04:40:44 PM CST. Install and authenticate via gh-cli to increase rate limit. ============================================================================== neoconf: require("neoconf.health").check() neoconf.nvim ~ - OK **treesitter-nvim** is installed - OK **TreeSitter jsonc** parser is installed - WARNING **neodev.nvim** is not installed. You won't get any proper completion for your Neovim config. - OK **lspconfig** is installed - OK **lspconfig jsonls** is installed - OK **lspconfig lua_ls** is installed ============================================================================== null-ls: require("null-ls.health").check() - OK clang_format: the command "clang-format" is executable. - OK prettier: the command "prettier" is executable. - OK gofumpt: the command "gofumpt" is executable. - OK shfmt: the command "shfmt" is executable. - OK stylua: the command "stylua" is executable. - OK vint: the command "vint" is executable. - OK goimports: the command "goimports" is executable. ============================================================================== nvim: require("nvim.health").check() Configuration ~ - OK no issues found Runtime ~ - OK $VIMRUNTIME: /ext/tools/squashfs-root/usr/share/nvim/runtime Performance ~ - OK Build type: Release Remote Plugins ~ - WARNING "wilder.nvim" is not registered. - WARNING Out of date - ADVICE: - Run `:UpdateRemotePlugins` terminal ~ - key_backspace (kbs) terminfo entry: `key_backspace=177` - key_dc (kdch1) terminfo entry: `key_dc=E[3~` - $SSH_TTY="/dev/pts/0" ============================================================================== nvim-treesitter: require("nvim-treesitter.health").check() Installation ~ - OK `tree-sitter` found 0.20.4 (714bfd47a744ab44b904375c177a24c0614ef49c) (parser generator, only needed for :TSInstallFromGrammar) - OK `node` found v16.18.1 (only needed for :TSInstallFromGrammar) - OK `git` executable found. - OK `cc` executable found. Selected from { vim.NIL, "cc", "gcc", "clang", "cl", "zig" } Version: cc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-44) - OK Neovim was compiled with tree-sitter runtime ABI version 14 (required >=13). Parsers must be compatible with runtime ABI. OS Info: { machine = "x86_64", release = "3.10.0-1160.21.1.el7.x86_64", sysname = "Linux", version = "#1 SMP Tue Mar 16 18:28:22 UTC 2021" } ~ Parser/Features H L F I J - bash ✓ ✓ ✓ . ✓ - c ✓ ✓ ✓ ✓ ✓ - cpp ✓ ✓ ✓ ✓ ✓ - css ✓ . ✓ ✓ ✓ - go ✓ ✓ ✓ ✓ ✓ - gomod ✓ . . . ✓ - html ✓ ✓ ✓ ✓ ✓ - javascript ✓ ✓ ✓ ✓ ✓ - json ✓ ✓ ✓ ✓ . - jsonc ✓ ✓ ✓ ✓ ✓ - latex ✓ . ✓ . ✓ - lua ✓ ✓ ✓ ✓ ✓ - make ✓ . ✓ . ✓ - markdown ✓ . ✓ ✓ ✓ - markdown_inline ✓ . . . ✓ - python ✓ ✓ ✓ ✓ ✓ - query ✓ ✓ ✓ ✓ ✓ - rust ✓ ✓ ✓ ✓ ✓ - typescript ✓ ✓ ✓ ✓ ✓ - vim ✓ ✓ ✓ . ✓ - vimdoc ✓ . . . ✓ - vue ✓ . ✓ ✓ ✓ - yaml ✓ ✓ ✓ ✓ ✓ Legend: H[ighlight], L[ocals], F[olds], I[ndents], In[j]ections +) multiple parsers found, only one will be used x) errors found in the query, try to run :TSUpdate {lang} ~ ============================================================================== provider: health#provider#check Clipboard (optional) ~ - WARNING No clipboard tool found. Clipboard registers (`"+` and `"*`) will not work. - ADVICE: - :help |clipboard| Python 3 provider (optional) ~ - Using: g:python3_host_prog = "python3" - Executable: /usr/bin/python3 - ERROR Command error (job=16, exit code 1): `'/usr/bin/python3' -c 'import sys; sys.path = ; import neovim; print(neovim.__file__)'` (in '/home/users/yunhai01/project/baidu/netdisk/p2p-sdk-mobile') stderr: Traceback (most recent call last): File "<string>", line 1, in <module>ModuleNotFoundError: No module named 'neovim' - Python version: 3.6.8 - pynvim version: unable to load neovim Python module - ERROR pynvim is not installed. Error: unable to load neovim Python module - ADVICE: - Run in shell: /usr/bin/python3 -m pip install pynvim Python virtualenv ~ - OK no $VIRTUAL_ENV Ruby provider (optional) ~ - WARNING `ruby` and `gem` must be in $PATH. - ADVICE: - Install Ruby and verify that `ruby` and `gem` commands work. Node.js provider (optional) ~ - Node.js: v16.18.1 - WARNING Missing "neovim" npm (or yarn, pnpm) package. - ADVICE: - Run in shell: npm install -g neovim - Run in shell (if you use yarn): yarn global add neovim - Run in shell (if you use pnpm): pnpm install -g neovim - You may disable this provider (and warning) by adding `let g:loaded_node_provider = 0` to your init.vim Perl provider (optional) ~ - WARNING Perl version is too old, 5.22+ required - ADVICE: - See :help |provider-perl| for more information. - You may disable this provider (and warning) by adding `let g:loaded_perl_provider = 0` to your init.vim ============================================================================== rainbow-delimiters: require("rainbow-delimiters.health").check() Custom strategies ~ - OK Valid custom default strategy. - OK Valid custom strategy for 'vim'. - OK Valid custom strategy for 'lua'. - OK Valid custom strategy for 'cpp'. - OK Valid custom strategy for 'vimdoc'. - OK Valid custom strategy for 'c'. Custom queries ~ - OK Valid custom default query - OK Valid custom query for 'javascript' - OK Valid custom query for 'latex' Custom highlight groups ~ - OK Highlight group 'RainbowDelimiterRed' defined. - OK Highlight group 'RainbowDelimiterOrange' defined. - OK Highlight group 'RainbowDelimiterYellow' defined. - OK Highlight group 'RainbowDelimiterGreen' defined. - OK Highlight group 'RainbowDelimiterBlue' defined. - OK Highlight group 'RainbowDelimiterCyan' defined. - OK Highlight group 'RainbowDelimiterViolet' defined. ============================================================================== telescope: require("telescope.health").check() Checking for required plugins ~ - OK plenary installed. - OK nvim-treesitter installed. Checking external dependencies ~ - OK rg: found ripgrep 13.0.0 - OK fd: found fd 8.5.3 ===== Installed extensions ===== ~ Telescope Extension: `aerial` ~ - No healthcheck provided Telescope Extension: `frecency` ~ - OK nvim-web-devicons installed. - OK ripgrep installed. Telescope Extension: `fzf` ~ - OK lib working as expected - OK file_sorter correctly configured - OK generic_sorter correctly configured Telescope Extension: `live_grep_args` ~ - No healthcheck provided Telescope Extension: `notify` ~ - No healthcheck provided Telescope Extension: `persisted` ~ - No healthcheck provided Telescope Extension: `projects` ~ - No healthcheck provided Telescope Extension: `undo` ~ - No healthcheck provided Telescope Extension: `zoxide` ~ - No healthcheck provided ============================================================================== vim.lsp: require("vim.lsp.health").check() - LSP log level : WARN - Log path: /home/users/yunhai01/.local/state/nvim/lsp.log - Log size: 54 KB vim.lsp: Active Clients ~ - clangd (id=1, root_dir=/home/users/yunhai01/project/baidu/netdisk/p2p-sdk-mobile) - null-ls (id=2, root_dir=/home/users/yunhai01/project/baidu/netdisk/p2p-sdk-mobile/project/src) - copilot (id=3, root_dir=/home/users/yunhai01/project/baidu/netdisk/p2p-sdk-mobile/project/src) ============================================================================== vim.treesitter: require("vim.treesitter.health").check() - Nvim runtime ABI version: 14 - OK Parser: bash ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/bash.so - OK Parser: c ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/c.so - OK Parser: cpp ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/cpp.so - OK Parser: css ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/css.so - OK Parser: go ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/go.so - OK Parser: gomod ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/gomod.so - OK Parser: html ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/html.so - OK Parser: javascript ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/javascript.so - OK Parser: json ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/json.so - OK Parser: jsonc ABI: 13, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/jsonc.so - OK Parser: latex ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/latex.so - OK Parser: lua ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/lua.so - OK Parser: make ABI: 13, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/make.so - OK Parser: markdown ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/markdown.so - OK Parser: markdown_inline ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/markdown_inline.so - OK Parser: python ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/python.so - OK Parser: rust ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/rust.so - OK Parser: typescript ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/typescript.so - OK Parser: vimdoc ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/vimdoc.so - OK Parser: vue ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/vue.so - OK Parser: yaml ABI: 14, path: /home/users/yunhai01/.local/share/nvim/site/lazy/nvim-treesitter/parser/yaml.so - OK Parser: c ABI: 14, path: /ext/tools/squashfs-root/usr/lib/nvim/parser/c.so - OK Parser: lua ABI: 14, path: /ext/tools/squashfs-root/usr/lib/nvim/parser/lua.so - OK Parser: query ABI: 14, path: /ext/tools/squashfs-root/usr/lib/nvim/parser/query.so - OK Parser: vim ABI: 14, path: /ext/tools/squashfs-root/usr/lib/nvim/parser/vim.so - OK Parser: vimdoc ABI: 14, path: /ext/tools/squashfs-root/usr/lib/nvim/parser/vimdoc.so ============================================================================== which-key: require("which-key.health").check() - ERROR Failed to run healthcheck for "which-key" plugin. Exception: function health#check, line 25 Vim(eval):E5108: Error executing lua ...are/nvim/site/lazy/which-key.nvim/lua/which-key/keys.lua:406: Invalid buffer id: 97 stack traceback: [C]: in function 'nvim_buf_get_keymap' ...are/nvim/site/lazy/which-key.nvim/lua/which-key/keys.lua:406: in function 'update_keymaps' ...e/nvim/site/lazy/which-key.nvim/lua/which-key/health.lua:15: in function 'check' [string "luaeval()"]:1: in main chunk
如果有插件工作不正常、老报警告框，可以通过自检发现一些问题。
主题
启动后默认的黑色背景看着黑乎乎的不够亮快，通过快捷键 (SPACE + f + c) 调出主题切换页：
这里选择 catppuccin-latte：
好多了。不过重启后就又恢复默认了，需要修改以下 lua 配置 (~/.config/nvim/lua/core/settings.lua)：
... -- Set the colorscheme to use here. -- Available values are: `catppuccin`, `catppuccin-latte`, `catppucin-mocha`, `catppuccin-frappe`, `catppuccin-macchiato`. ---@type string settings["colorscheme"] = "catppuccin" -- Set it to true if your terminal has transparent background. ---@type boolean settings["transparent_background"] = false -- Set background color to use here. -- Useful if you would like to use a colorscheme that has a light and dark variant like `edge`. -- Valid values are: `dark`, `light`. ---@type "dark"|"light" settings["background"] = "dark" ...本来是想改 colorscheme 选项的，后来发现有个 background = dark，尝试将这个改为 light 试试，重启后默认主题自动切换为 catppuccin-latte 了，下面是主题实时切换的效果：
2 核 CPU 切换有点费劲，毕竟是老旧机器，将就看吧~
状态栏
上一节中切换主题时，好多 scheme 套件的状态栏展示有问题，黑乎乎的一块显示不清楚，这是由于状态栏使用的插件 lualine 有自己的主题，需要单独设置，由于 lualine 属于插件，它们的配置文件位置稍有不同 (~/.config/nvim/lua/modules/configs/ui/lualine.lua)：
... local function custom_theme() vim.api.nvim_create_autocmd("ColorScheme", { group = vim.api.nvim_create_augroup("LualineColorScheme", { clear = true }), pattern = "*", callback = function() has_catppuccin = vim.g.colors_name:find("catppuccin") ~= nil require("lualine").setup({ options = { theme = custom_theme() } }) end, }) ...主要修改 require("lualine").setup 一行中 theme = 的值即可，可供选择的值参考这篇。从代码上看，对于 catppuccin-* 主题，会做状态栏的同步，所以相对要好一些，可以无脑选择。
目前 nvimdots 对老旧系统的支持已经不错了，早先我设置 blue 主题时，状态栏是这个样子：
根本没法看，通过设置 lualine 主题为 onenight 解决了这个问题：
目前已经不需要单独进行设置了。
快捷键
nvimdots 提供了很丰富的快捷键支持，一般都是三键组合，例如 <leader>+f+w 进入关键字搜索，其中 <leader> 是可定义的，目前默认为空格键。
通过 :verbose nmap 可以查看所有的键映射：
想看单独的键可以在后面增加参数，例如输入 :verbose nmap gD ：
常用的 gD、gd、gh、gf、gr、K 都有说明。自定义的键映射位于：~/.config/nvim/lua/core/mapping.lua
local bind = require("keymap.bind") local map_cr = bind.map_cr local map_cu = bind.map_cu local map_cmd = bind.map_cmd local map_callback = bind.map_callback local core_map = { -- Suckless ["n|<S-Tab>"] = map_cr("normal za"):with_noremap():with_silent():with_desc("edit: Toggle code fold"), ["n|<C-s>"] = map_cu("write"):with_noremap():with_silent():with_desc("edit: Save file"), ["n|Y"] = map_cmd("y$"):with_desc("edit: Yank text to EOL"), ["n|D"] = map_cmd("d$"):with_desc("edit: Delete text to EOL"), ["n|n"] = map_cmd("nzzzv"):with_noremap():with_desc("edit: Next search result"), ["n|N"] = map_cmd("Nzzzv"):with_noremap():with_desc("edit: Prev search result"), ["n|J"] = map_cmd("mzJ`z"):with_noremap():with_desc("edit: Join next line"), ["n|<Esc>"] = map_callback(function() _flash_esc_or_noh() end) :with_noremap() :with_silent() :with_desc("edit: Clear search highlight"), ["n|<C-h>"] = map_cmd("<C-w>h"):with_noremap():with_desc("window: Focus left"), ["n|<C-l>"] = map_cmd("<C-w>l"):with_noremap():with_desc("window: Focus right"), ["n|<C-j>"] = map_cmd("<C-w>j"):with_noremap():with_desc("window: Focus down"), ["n|<C-k>"] = map_cmd("<C-w>k"):with_noremap():with_desc("window: Focus up"), ["t|<C-w>h"] = map_cmd("<Cmd>wincmd h<CR>"):with_silent():with_noremap():with_desc("window: Focus left"), ["t|<C-w>l"] = map_cmd("<Cmd>wincmd l<CR>"):with_silent():with_noremap():with_desc("window: Focus right"), ["t|<C-w>j"] = map_cmd("<Cmd>wincmd j<CR>"):with_silent():with_noremap():with_desc("window: Focus down"), ["t|<C-w>k"] = map_cmd("<Cmd>wincmd k<CR>"):with_silent():with_noremap():with_desc("window: Focus up"), ["n|<A-h>"] = map_cr("vertical resize -3"):with_silent():with_desc("window: Resize -3 vertically"), ["n|<A-l>"] = map_cr("vertical resize +3"):with_silent():with_desc("window: Resize +3 vertically"), ["n|<A-j>"] = map_cr("resize -3"):with_silent():with_desc("window: Resize -3 horizontally"), ["n|<A-k>"] = map_cr("resize +3"):with_silent():with_desc("window: Resize +3 horizontally"), ["n|<C-q>"] = map_cr("wq"):with_desc("edit: Save file and quit"), ["n|<A-S-q>"] = map_cr("q!"):with_desc("edit: Force quit"), ["n|<leader>o"] = map_cr("setlocal spell! spelllang=en_us"):with_desc("edit: Toggle spell check"), ["n|tn"] = map_cr("tabnew"):with_noremap():with_silent():with_desc("tab: Create a new tab"), ["n|tk"] = map_cr("tabnext"):with_noremap():with_silent():with_desc("tab: Move to next tab"), ["n|tj"] = map_cr("tabprevious"):with_noremap():with_silent():with_desc("tab: Move to previous tab"), ["n|to"] = map_cr("tabonly"):with_noremap():with_silent():with_desc("tab: Only keep current tab"), -- Insert mode ["i|<C-u>"] = map_cmd("<C-G>u<C-U>"):with_noremap():with_desc("edit: Delete previous block"), ["i|<C-b>"] = map_cmd("<Left>"):with_noremap():with_desc("edit: Move cursor to left"), ["i|<C-a>"] = map_cmd("<ESC>^i"):with_noremap():with_desc("edit: Move cursor to line start"), ["i|<C-s>"] = map_cmd("<Esc>:w<CR>"):with_desc("edit: Save file"), ["i|<C-q>"] = map_cmd("<Esc>:wq<CR>"):with_desc("edit: Save file and quit"), -- Command mode ["c|<C-b>"] = map_cmd("<Left>"):with_noremap():with_desc("edit: Left"), ["c|<C-f>"] = map_cmd("<Right>"):with_noremap():with_desc("edit: Right"), ["c|<C-a>"] = map_cmd("<Home>"):with_noremap():with_desc("edit: Home"), ["c|<C-e>"] = map_cmd("<End>"):with_noremap():with_desc("edit: End"), ["c|<C-d>"] = map_cmd("<Del>"):with_noremap():with_desc("edit: Delete"), ["c|<C-h>"] = map_cmd("<BS>"):with_noremap():with_desc("edit: Backspace"), ["c|<C-t>"] = map_cmd([[<C-R>=expand("%:p:h") . "/" <CR>]]) :with_noremap() :with_desc("edit: Complete path of current file"), -- Visual mode ["v|J"] = map_cmd(":m '>+1<CR>gv=gv"):with_desc("edit: Move this line down"), ["v|K"] = map_cmd(":m '<-2<CR>gv=gv"):with_desc("edit: Move this line up"), ["v|<"] = map_cmd("<gv"):with_desc("edit: Decrease indent"), ["v|>"] = map_cmd(">gv"):with_desc("edit: Increase indent"), } bind.nvim_load_mapping(core_map)这里有两个键是我之前用习惯的：Ctrl+j 向上移屏一行、Ctrl+k 向下移屏一行。vim 将这两个键映射到了 Ctrl+e 和 Ctrl+y，一直觉得用着不太顺手，可以手动添加：
:nmap <C-j> <C-e> :nmap <C-k> <C-y>然而重启 nvim 后就不起作用了。可以在上面的配置文件中加入以下内容实现永久修改：
-- Move Up/Down ["n|<C-h>"] = map_cmd("<C-e>"), ["n|<C-l>"] = map_cmd("<C-y>"), ["n|<C-k>"] = map_cmd("<C-y>"):with_noremap(), ["n|<C-j>"] = map_cmd("<C-e>"):with_noremap(),注意由于 Ctrl+h/j/k/l 已被 nvimdots 挪为它用，为防止热键冲突，需要将之前的注释掉：
-- ["n|<C-h>"] = map_cmd("<C-w>h"):with_noremap():with_desc("window: Focus left"), -- ["n|<C-l>"] = map_cmd("<C-w>l"):with_noremap():with_desc("window: Focus right"), -- ["n|<C-j>"] = map_cmd("<C-w>j"):with_noremap():with_desc("window: Focus down"), -- ["n|<C-k>"] = map_cmd("<C-w>k"):with_noremap():with_desc("window: Focus up"),看起来是用于窗口切换 (Ctrl+w+h/j/k/l) 了，感觉没啥必要。注意看 Ctrl+j 与 Ctrl+h、Ctrl+k 与 Ctrl+l 只相差了一个 :with_noremap()，这个能起什么作用？看下面这个演示就清楚了：
加了了 :with_noremap() 的，会上下滑动多行，实现按更少的键的目的。
PS：目前在新版本的 nvimdots 上，新增的键还是不起作用，目前还没有精力研究，回头研究通了再更新一波~
编程语言支持
相比于主流的 IDE 只能支持若干编程语言，neovim+nvimdots 搭建的 IDE 更加强大，可以轻松支持几十种语言，是冷门语言开发者的福音。输入 :LspInfo 查看已安装的语言服务：
这是 nvimdots 的默认配置，可以通过修改配置文件来增加或删除语言服务 (~/.config/nvim/lua/core/settings.lua)：
... -- Set the language servers that will be installed during bootstrap here. -- check the below link for all the supported LSPs: -- https://github.com/neovim/nvim-lspconfig/tree/master/lua/lspconfig/server_configurations ---@type string[] settings["lsp_deps"] = { "bashls", "clangd", "html", "jsonls", "lua_ls", "pylsp", "gopls", } -- Set the general-purpose servers that will be installed during bootstrap here. -- Check the below link for all supported sources. -- in `code_actions`, `completion`, `diagnostics`, `formatting`, `hover` folders: -- https://github.com/nvimtools/none-ls.nvim/tree/main/lua/null-ls/builtins ---@type string[] settings["null_ls_deps"] = { "clang_format", "gofumpt", "goimports", "prettier", "shfmt", "stylua", "vint", } -- Set the Debug Adapter Protocol (DAP) clients that will be installed and configured during bootstrap here. -- Check the below link for all supported DAPs: -- https://github.com/jay-babu/mason-nvim-dap.nvim/blob/main/lua/mason-nvim-dap/mappings/source.lua ---@type string[] settings["dap_deps"] = { "codelldb", -- C-Family "delve", -- Go "python", -- Python (debugpy) } ...主要就是修改 lsp_deps 数组了。例如对于不需要且没有安装成功的 pylsp 和 gopls，直接删除之。重启 nvim 后，不再报烦人的警告了。
另外 checkhealth 中也有 tree-sitter 支持的语言列表：
Parser/Features H L F I J - bash ✓ ✓ ✓ . ✓ - c ✓ ✓ ✓ ✓ ✓ - cpp ✓ ✓ ✓ ✓ ✓ - css ✓ . ✓ ✓ ✓ - go ✓ ✓ ✓ ✓ ✓ - gomod ✓ . . . ✓ - html ✓ ✓ ✓ ✓ ✓ - javascript ✓ ✓ ✓ ✓ ✓ - json ✓ ✓ ✓ ✓ . - jsonc ✓ ✓ ✓ ✓ ✓ - latex ✓ . ✓ . ✓ - lua ✓ ✓ ✓ ✓ ✓ - make ✓ . ✓ . ✓ - markdown ✓ . ✓ ✓ ✓ - markdown_inline ✓ . . . ✓ - python ✓ ✓ ✓ ✓ ✓ - query ✓ ✓ ✓ ✓ ✓ - rust ✓ ✓ ✓ ✓ ✓ - typescript ✓ ✓ ✓ ✓ ✓ - vim ✓ ✓ ✓ . ✓ - vimdoc ✓ . . . ✓ - vue ✓ . ✓ ✓ ✓ - yaml ✓ ✓ ✓ ✓ ✓ Legend: H[ighlight], L[ocals], F[olds], I[ndents], In[j]ections +) multiple parsers found, only one will be used x) errors found in the query, try to run :TSUpdate {lang} ~每列为一个功能点，每行为一种语言，全打勾表示所有功能在线。
保存时美化
各种 formatter 设置好了不用岂不可惜，所以 nvimdots 默认的行为是关闭文件自动使用对应语言的 formatter 进行格式美化。然而在浏览第三方库文件或其它开源库代码时，这么做就有点画蛇添足了，通过 FormatToggle 可以关闭默认选项，然而重启 nvim 后又会自动打开，因此需要修改配置文件 (~/.config/nvim/lua/core/settings.lua)：
... -- Set it to false if there are no need to format on save. ---@type boolean settings["format_on_save"] = true -- Set it to false if the notification after formatting is annoying. ---@type boolean settings["format_notify"] = true -- Set it to true if you prefer formatting ONLY the *changed lines* as defined by your version control system. -- NOTE: This entry will only be respected if: -- > The buffer to be formatted is under version control (Git or Mercurial); -- > Any of the server attached to that buffer supports |DocumentRangeFormattingProvider| server capability. -- Otherwise Neovim would fall back to format the whole buffer, and a warning will be issued. ---@type boolean settings["format_modifications_only"] = false -- Set the format disabled directories here, files under these dirs won't be formatted on save. --- NOTE: Directories may contain regular expressions (grammar: vim). |regexp| --- NOTE: Directories are automatically normalized. |vim.fs.normalize()| ---@type string[] settings["format_disabled_dirs"] = { -- Example "~/format_disabled_dir", } ...将 format_on_save 改为 false 即可。
效果
至此基于 neovim 的 IDE 就搭建完成了，在正式开始演试之前，需要为 efm-langserver 插件生成一份代码编译清单：compile_commands.json。
compile_commands
这个文件的内容是实际传递给编译器的命令行，包括各种参数：
... { "directory": "/ext/code/transmission/build/libtransmission", "command": "/opt/compiler/gcc-8.2/bin/g++ -DCURL_STATICLIB -DFMT_EXCEPTIONS=0 -DFMT_HEADER_ONLY=1 -DHAVE_FALLOCATE64 -DHAVE_FLOCK -DHAVE_GETMNTENT -DHAVE_GETTEXT -DHAVE_LIBINTL_H -DHAVE_MKDTEMP -DHAVE_NGETTEXT -DHAVE_POSIX_FADVISE -DHAVE_POSIX_FALLOCATE -DHAVE_PREAD -DHAVE_PWRITE -DHAVE_SENDFILE64 -DHAVE_SO_REUSEPORT=1 -DHAVE_STATVFS -DHAVE_SYS_STATVFS_H -DHAVE_XLOCALE_H -DMINIUPNP_STATICLIB -DNATPMP_STATICLIB -DPACKAGE_DATA_DIR=\"/usr/local/share\" -DPOSIX -DSYSTEM_MINIUPNP -DWIDE_INTEGER_DISABLE_FLOAT_INTEROP -DWIDE_INTEGER_DISABLE_IOSTREAM -DWITH_INOTIFY -DWITH_UTP -D__TRANSMISSION__ -I/ext/code/transmission/build/libtransmission -I/ext/code/transmission/third-party/libutp/include -I/ext/code/transmission/third-party/libb64/include -I/ext/code/transmission/third-party/jsonsl -I/ext/code/transmission/third-party/wildmat -isystem /ext/code/transmission/build/third-party/libdeflate.bld/pfx/include -isystem /usr/local/include -isystem /ext/code/transmission/cmake/../third-party/fast_float/include -isystem /ext/code/transmission/build/third-party/libpsl.bld/pfx/include -isystem /ext/code/transmission/build/third-party/libnatpmp.bld/pfx/include -isystem /ext/code/transmission/build/third-party/miniupnpc.bld/pfx/include -isystem /ext/code/transmission/build/third-party/dht.bld/pfx/include -isystem /ext/code/transmission/cmake/../third-party/utfcpp/source -isystem /ext/code/transmission/cmake/../third-party/wide-integer -isystem /ext/code/transmission/cmake/../third-party/fmt/include -isystem /ext/code/transmission/build/third-party/libevent.bld/pfx/include -O3 -DNDEBUG -fPIC -W -Wall -Wextra -Wcast-align -Wduplicated-cond -Wextra-semi -Wfloat-equal -Winit-self -Wint-in-bool-context -Wlogical-op -Wmissing-format-attribute -Wnull-dereference -Wpointer-arith -Wredundant-decls -Wrestrict -Wshadow -Wsign-compare -Wsuggest-override -Wuninitialized -Wunreachable-code -Wunused -Wunused-const-variable -Wunused-parameter -Wunused-result -Wwrite-strings -std=gnu++17 -o CMakeFiles/transmission.dir/session.cc.o -c /ext/code/transmission/libtransmission/session.cc", "file": "/ext/code/transmission/libtransmission/session.cc" }, ...如此，efm-langserver 等语言服务，就能借助这里的信息，更好的理解代码，例如哪些预处理中的代码是生效的，从而更好的实现符号跳转与补全等功能。这类清单也用于 ccls、VSCode 等 IDE 中，并不是 efm-langserver 专属的。一般项目本身并不包含这类清单，需要单独生成一下，下面分项目类型分别介绍。
- cmake：cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1 .
- make：bear make
- Android NDK
- ndk-build GEN_COMPILE_COMMANDS_DB=true
- bear ndk-build
- ninja：ninja -f out/combined-kona.ninja -t compdb | tee ./compile_commands.json
- ...
cmake、ninja 支持的比较好，NDK 算 make 的一种，也有自己的选项可以设置，对于最原始的 make，只能借助于 bear 命令了，另外 ndk-build 也可以基于这种方式生成。
bear
bear 是一个用来生成包含编译时选项的数据库的工具。 通常它将输出文件 compile_commands.json ，可以供给例如 vscode 中的 Microsoft C/C++ 插件或者 vim 中的 YouCompleteMe 插件使用，让插件可以正确的解析当前 C++ 源文件的各种依赖信息，例如头文件包含路径。
在 CentOS 上默认没有这个命令，需要安装一下，默认的 yum 源没有，需要源码安装：
wget https://github.com/rizsotto/Bear/archive/refs/tags/2.4.4.zip unzip 2.4.4.zip cd Bear-2.4.4 mkdir build; cd build cmake .. make sudo make install安装过程也比较简单，CentOS7 适合老一点的版本，2.4.4 实测可用。
transmission
下面用一个 BitTorrent 网络传输方面很知名的开源库 tranmission 从头到尾做个测试。
git clone --recurse-submodules git@github.com:firedgirl/transmission.git transmission cd transmission git checkout -b 4.0.x origin/4.0.x mkdir build; cd build cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1 -DCMAKE_CXX_COMPILER=/opt/compiler/gcc-8.2/bin/g++ -DCMAKE_C_COMPILER=/opt/compiler/gcc-8.2/bin/gcc -DCMAKE_CXX_FLAGS="-Wl,-rpath,/opt/compiler/gcc-8.2/lib64 -I /usr/local/include" -DCMAKE_BUILD_TYPE=Release .. make -j8注意添加到 cmake 中的 -DCMAKE_EXPORT_COMPILE_COMMANDS=1 选项，他的作用和 bear 是一致的。项目编译完成后，将在根目录生成一个 compile_commands.json 文件，内容比较多就不展示了，感兴趣的可以看这个链接。
将它移动到项目根目录，打开 neovim，就可以像 VSCode 一样浏览啦。上面的 transmission 只是一个例子，可以更换为任意 c/c++ 开源库。有的平台不支持 compile_commands.json 的生成，此时符号跳转就没那么准了，不过文件内的一些函数定义跳转还是支持的。
功能展示
自动补全
这里演示的是成员变量与成员函数，其它像普通变量、函数调用什么的也都能自动补全。
字符串查找
Telescope 插件，底层基于 fzf & rg，快捷键 SPACE + f + w 调出。缺点有以下几点
- 多次查询一个关键字不便，需要每次输入关键词且从头开始遍历
- 跳转到某个文件再查找，会局限查找范围为文件当前所在目录
对于第二个问题，在老版本上通过修改配置可以修复，具体修改 ~/.config/nvim/lua/core/event.lua：
{ "BufEnter", "*", "silent! lcd %:p:h" },将上面这行注释掉即可。但是目前新版本，这个配置不见了，目前还没有抽出精力来研究。
符号跳转
上图演示了几种典型的跳转场景：
- gD：声明、调用点跳转定义
- K：提示定义
- gd：小窗显示定义
除了 c++ 中的虚函数都能比较好的进行处理，虚函数由于是运行时才能确定调用哪个实现，这里跳不过去也情有可原，但是如果能将备选的实现列出来让用户自己选择，就更好了。
上面的动图，展示的是 gh 命令查找所有调用点，在弹出的浮窗中，右侧按文件列出所有调用点，进入文件下面每个调用点时，左侧可以预览，回车时跳转到调用点。大部分时间可用，有时一些符号找不到，就得使用之前的字符串查找了。
h/cpp 文件切换
ClangdSwitchSourceHeaderVSplit，基于 clangd，快捷键 SPACE + h 调出，同级别的还可以使用 ClangdSwitchSourceHeader & ClangdSwitchSourceHeaderSplit，前者直接替换当前 buffer，后者是横向分屏，可以让 SPACE + h 指向其中任何一个，看个人偏好。头文件可以不必和 cpp 在同一个目录，这个插件一样可以找到。
后记
第一次入坑 neovm + nvimdots 是 2022.11 的事情了，最近有新机器了又在 2024.07 搞了一次，发现nvimdots 有很大更新，以至于之前的一些快捷键、UI 发生了变化，一些移植经验也已经不适用了，虽然一度很懵逼，但这是一件好事，说明 neovim + 基于 lua 的插件配置正在蓬勃发展，现在写出来的文字，可能过一两年又面目全非了。总归来说，现在这条路是对的，比那些还在坚守 vim + gtags + cscope + YouCompleteMe… 老路的要强大太多了，现在网上这方面的资料，远远跟不上开源社区的进步速度，毫不夸张的说，关于 vim 搭建现代化 IDE 的文章，只要超过五年以上，就是老古董了，除非研究技术发展历史，否则没必要深究。
基于 lua 的 neovim 配置还有很多，nvimdots 只是其中的一个，其实他们采用的基础插件是相通的，像 Lazy、Mason、Lsp 等等，这种项目像一个粘合剂，将各种零散的小插件整合在一起，达到用户开箱即用的效果，免去了很多插件搜索的过程，各位有使用的好的项目，也可以在留言区分享哈~
关于 nvimdots 的任何使用问题都可以在 Issue 页面提问，之前我在这里提的一些问题，很快就有人回复，一些不错的建议还得到了采纳，成就感满满！总之，除了一帮子中国人在那飙英文有点受不了，其它都还好😅。
参考
[1]. Linux(Ubuntu/CentOS) 下查看 GLIBC 版本
[2]. 升级glibc至2.18
[3]. 通过ipaddress更新github的hostsIP
[4]. Can one set std=c99 in GCC as a default? [duplicate]
[5]. yum安装指定版本软件包
[6]. The Cargo Book
[8]. ayamir/nvimdots
[9]. Neovim 代码高亮插件 nvim-treesitter 的安装与配置
[10]. lazy-nvim插件管理器基础入门
[11]. neovim入门指南(一)：基础配置
[12]. 我的现代化Neovim配置
[13]. 详解nvim内建LSP体系与基于nvim-cmp的代码补全体系
[14]. CentOS7 使用脚本安装后插件一直报下载失败 #326
[15]. CentOS7 安装后 scheme 无法保存
[16]. gd/D 不能跳转到定义
[17]. change theme can't change status line theme
[18]. how to disable FormatOnSave permanently?
[19]. How can I map C-j to C-e in lua
[20]. 生成compile_commands.json文件
[21]. Android C++ 生成 compile_commands.json
[22]. Bear 2.4.4 精简版
[23]. How can I traverse functions with jump list?
