干這行久了你會(huì)發(fā)現(xiàn)一件事真正考驗(yàn)?zāi)愕牟皇枪δ軐?xiě)得有多花哨而是部署環(huán)境有多爛。我印象最深的一次是給一臺(tái)物理隔離的AI訓(xùn)練服務(wù)器配開(kāi)發(fā)環(huán)境要求是“能離線(xiàn)寫(xiě)完代碼并且保證語(yǔ)法高亮、補(bǔ)全、文件樹(shù)都好用”。那臺(tái)機(jī)器沒(méi)有外網(wǎng)連apt源都只能走內(nèi)網(wǎng)鏡像我抱著一個(gè)2.5寸移動(dòng)硬盤(pán)折騰了整整一下午。也就是從那次之后我把“vim插件的管理與離線(xiàn)安裝”徹底吃透了。這東西聽(tīng)著小真做起來(lái)涉及vim的運(yùn)行時(shí)機(jī)制、插件管理器的行為差異、依賴(lài)工具的離線(xiàn)打包一個(gè)環(huán)節(jié)沒(méi)想清楚換個(gè)環(huán)境就翻車(chē)。我估計(jì)你現(xiàn)在搜這些詞要么就是內(nèi)網(wǎng)開(kāi)發(fā)機(jī)、要么就是給無(wú)網(wǎng)服務(wù)器補(bǔ)文檔要么就是被那句“package vim is not available, but is referred to by another package. this ma”搞到頭大。這幾種情況我都經(jīng)歷過(guò)下面把整個(gè)過(guò)程拆開(kāi)揉碎寫(xiě)出來(lái)。1. 先搞清楚原理Vim插件管理到底管的是什么要搞定離線(xiàn)安裝第一步不是急著拷貝文件而是理解vim加載插件的底層邏輯。否則你大概率會(huì)遇到“文件放進(jìn)去了vim卻毫無(wú)反應(yīng)”的靈異事件。1.1 插件的本質(zhì)就是一堆腳本文件vim插件說(shuō)白了就是一批特定目錄結(jié)構(gòu)的腳本文件絕大多數(shù)插件由這些部分組成plugin/目錄vim啟動(dòng)時(shí)自動(dòng)加載的腳本比如按鍵映射、命令定義autoload/目錄按需加載的腳本用到對(duì)應(yīng)函數(shù)時(shí)才讀取syntax/目錄語(yǔ)法高亮文件ftplugin/目錄文件類(lèi)型插件進(jìn)入特定類(lèi)型文件時(shí)生效doc/目錄幫助文檔需要helptags命令生成tagsafter/目錄晚于系統(tǒng)腳本生效的定制內(nèi)容這些目錄按特定規(guī)則拼到runtimepath上vim啟動(dòng)時(shí)挨個(gè)去這些目錄里找plugin/*.vim然后執(zhí)行。所以插件管理的核心操作不是“復(fù)制文件”而是“讓vim的runtimepath里出現(xiàn)插件的路徑”。我見(jiàn)過(guò)不少人手動(dòng)安裝插件直接把整個(gè)插件目錄扔進(jìn)~/.vim/結(jié)果plugin目錄被平鋪混在一起互相覆蓋、加載順序亂套。這就是不理解runtimepath機(jī)制導(dǎo)致的典型問(wèn)題。1.2 手動(dòng)安裝的三種姿勢(shì)與痛點(diǎn)在沒(méi)有插件管理器的遠(yuǎn)古時(shí)期裝插件就三種辦法第一種是把插件倉(cāng)庫(kù)clone或解壓到~/.vim/里讓插件的plugin/自然成為~/.vim/plugin/的子目錄。這種方式的優(yōu)點(diǎn)是簡(jiǎn)單缺點(diǎn)是不同插件的同名文件會(huì)相互污染更新覆蓋時(shí)容易丟東西。第二種是把插件放到~/.vim/bundle/這類(lèi)目錄然后在vimrc里用set rtp~/.vim/bundle/某插件一行一行手動(dòng)加。這種方式比第一種好隔離了插件但vimrc會(huì)被幾十行rtp占滿(mǎn)加一個(gè)插件要改一次配置。第三種是用autoload做lazy load的雛形把插件丟進(jìn)~/.vim/autoload/靠函數(shù)名觸發(fā)。這種寫(xiě)法對(duì)插件作者來(lái)說(shuō)很方便但對(duì)用戶(hù)來(lái)說(shuō)需要理解vim的autoload命名規(guī)則門(mén)檻比較高。手動(dòng)方案在只有三五個(gè)插件時(shí)完全夠用一旦超過(guò)十個(gè)升級(jí)、清理、按需加載就會(huì)變成災(zāi)難。更麻煩的是手動(dòng)方案對(duì)“離線(xiàn)安裝”特別不友好——你根本不知道某個(gè)插件還依賴(lài)哪些其他插件拷貝了一堆文件卻缺了依賴(lài)連報(bào)錯(cuò)都是莫名其妙的那種。1.3 插件管理器到底替你做了什么嚴(yán)格來(lái)說(shuō)vim插件管理器vim-plug、Vundle、dein.vim、packer.nvim這些做的事可以歸納成三件管理runtimepath在vimrc里聲明插件列表啟動(dòng)時(shí)把每個(gè)插件的路徑拼進(jìn)runtimepath省去了手動(dòng)rtp的麻煩管理獲取與更新從GitHub、GitLab等遠(yuǎn)程倉(cāng)庫(kù)clone、拉取更新或從本地路徑讀取管理構(gòu)建流程部分插件需要生成幫助tags、編譯C組件或生成補(bǔ)全緩存管理器會(huì)自動(dòng)跑這些后處理拿現(xiàn)在最流行的vim-plug舉例在線(xiàn)時(shí)你的vimrc里大概是這樣的call plug#begin(~/.vim/plugged) Plug preservim/nerdtree Plug junegunn/fzf, { dir: ~/.fzf, do: ./install --all } Plug neoclide/coc.nvim, {branch: release} call plug#end():PlugInstall時(shí)vim-plug會(huì)逐個(gè)去https://github.com/preservim/nerdtree執(zhí)行g(shù)it clone。它把插件倉(cāng)庫(kù)克隆到~/.vim/plugged/里文件名和Plug聲明的倉(cāng)庫(kù)名直接對(duì)應(yīng)。理解了這個(gè)機(jī)制離線(xiàn)的思路就豁然開(kāi)朗了vim-plug需要的那條git clone在離線(xiàn)機(jī)器上既然跑不通那我在有網(wǎng)的機(jī)器上把倉(cāng)庫(kù)克隆好整個(gè)~/.vim/plugged目錄拷過(guò)去不就完了這是離線(xiàn)安裝的第一層理解。第二層理解是連vim-plug都不需要vim 8.0之后自帶的packpath機(jī)制是更穩(wěn)的方案后面細(xì)說(shuō)。2. 離線(xiàn)安裝方案一用vim-plug的本地路徑和打包大法vim-plug是當(dāng)前最常用的管理器搞離線(xiàn)的思路也是最好講的。如果你只是給一臺(tái)內(nèi)網(wǎng)機(jī)配上常用的幾個(gè)插件這個(gè)方案最省事。2.1 先在有網(wǎng)絡(luò)環(huán)境的機(jī)器上準(zhǔn)備好插件包我建議在辦公室或者自己電腦上建一個(gè)“離線(xiàn)分發(fā)目錄”專(zhuān)門(mén)用來(lái)給內(nèi)網(wǎng)機(jī)器打包vim環(huán)境。假設(shè)這個(gè)目錄叫vim-dist/操作流程如下mkdir -p vim-dist cd vim-dist git clone --depth 1 https://github.com/preservim/nerdtree.git git clone --depth 1 https://github.com/vim-airline/vim-airline.git git clone --depth 1 https://github.com/ctrlpvim/ctrlp.vim.git這里加了--depth 1只拉取最新一次提交的代碼體積能小很多。沒(méi)有外網(wǎng)git權(quán)限的話(huà)也可以在GitHub網(wǎng)頁(yè)端點(diǎn)Download ZIP然后解壓。注意解壓后目錄名通常叫nerdtree-main需要手動(dòng)重命名成nerdtree因?yàn)関im-plug對(duì)本地目錄名沒(méi)有嚴(yán)格對(duì)應(yīng)要求但你自己看得明白更省事。我習(xí)慣把所有插件源文件統(tǒng)一放到一個(gè)目錄然后通過(guò)兩個(gè)途徑分發(fā)一是整個(gè)目錄打包壓縮二是直接拷到目標(biāo)機(jī)器的~/.vim/plugged/下。為什么建議放plugged而不是放別處因?yàn)樵趘im-plug的世界里plugged就是它的默認(rèn)安裝目錄vimrc里plug#begin(~/.vim/plugged)指的就是這里。2.2 修改vimrc把Plug指向本地目錄vim-plug對(duì)本地路徑的支持很友好。你不需要聯(lián)網(wǎng)在vimrc里這樣寫(xiě)call plug#begin(~/.vim/plugged) Plug ~/.vim/plugged/nerdtree Plug ~/.vim/plugged/vim-airline Plug ~/.vim/plugged/ctrlp.vim call plug#end()然后啟動(dòng)vim執(zhí)行:PlugInstall。vim-plug看到路徑是本地絕對(duì)路徑不會(huì)發(fā)起遠(yuǎn)程clone而是驗(yàn)證目錄存在后幫你把路徑寫(xiě)進(jìn)runtimepath。這一步即便是在斷網(wǎng)機(jī)器上也是能成功執(zhí)行的。但這里有個(gè)容易踩的坑不同版本的vim-plug對(duì)本地路徑的處理細(xì)節(jié)不太一樣。老版本有可能會(huì)嘗試從路徑里解析倉(cāng)庫(kù)名然后仍然去clone我遇到過(guò)Plug ~/.vim/plugged/xxx這種寫(xiě)法在某些舊版本下依然聯(lián)網(wǎng)的情況。穩(wěn)妥起見(jiàn)直接把插件倉(cāng)庫(kù)放進(jìn)begin()指向的目錄里路徑只寫(xiě)到plugged/下那一層不要帶多余的層級(jí)。我最推薦的做法其實(shí)是打包整個(gè)~/.vim目錄。在有網(wǎng)機(jī)器上先把插件通過(guò)正常的:PlugInstall裝好確認(rèn)全部能用然后整個(gè)打包tar czf vim-env.tar.gz .vim .vimrc拷到目標(biāo)機(jī)器后在$HOME下解壓tar xzf vim-env.tar.gz因?yàn)関im-plug的plugged目錄是“git clone出來(lái)的倉(cāng)庫(kù)目錄”目標(biāo)機(jī)器上不需要聯(lián)網(wǎng)vim啟動(dòng)時(shí)按vimrc里的聲明逐個(gè)檢查目錄存在與否存在就直接加載。這個(gè)方案是我給內(nèi)網(wǎng)機(jī)器配環(huán)境的主力方法簡(jiǎn)單粗暴百分之百能復(fù)現(xiàn)。2.3 離線(xiàn)時(shí)別忽略vim-plug自身的安裝還有一個(gè)容易忽略的點(diǎn)vim-plug本身也是一個(gè)插件需要放到autoload/下面。通常安裝方式是運(yùn)行一段curl命令從raw.githubusercontent.com下載plug.vim。你離線(xiàn)環(huán)境下那段命令注定跑不通所以務(wù)必要在有網(wǎng)機(jī)器上先把plug.vim下載好。curl -fLo ~/.vim/autoload/plug.vim --create-dirs \ https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim拷過(guò)去的時(shí)候注意目錄結(jié)構(gòu)~/.vim/autoload/plug.vim。位置錯(cuò)了vimrc里的call plug#begin()立刻報(bào)錯(cuò)E117: Unknown function: plug#begin。我踩過(guò)這個(gè)坑當(dāng)時(shí)下載的文件放到了~/.vim/plugin/vim直接把plug.vim當(dāng)普通插件在啟動(dòng)階段執(zhí)行了結(jié)果一堆函數(shù)還沒(méi)定義好就互相調(diào)用報(bào)錯(cuò)根本沒(méi)法看。3. 離線(xiàn)安裝方案二用Vim原生packpath最穩(wěn)的方案如果你在離線(xiàn)的機(jī)器上連vim-plug也不想裝或者你干脆要做一個(gè)“極簡(jiǎn)依賴(lài)”的分發(fā)環(huán)境那就直接用Vim 8.0以后內(nèi)置的packpath機(jī)制。這是最不依賴(lài)外部工具、純vim原生支持的方案。3.1 packpath機(jī)制長(zhǎng)什么樣Vim 8.0引入了一個(gè)叫作packages的功能核心是通過(guò)固定的目錄結(jié)構(gòu)實(shí)現(xiàn)插件加載無(wú)需任何管理器。只要在vimrc里加了packloadallvim啟動(dòng)時(shí)會(huì)自動(dòng)掃描這些目錄~/.vim/pack/包名/start/插件名 ~/.vim/pack/包名/opt/插件名pack/中間的這層目錄叫包名你可以隨便起比如vendor、myplugins、work都可以。它的作用只是分類(lèi)管理。真正決定加載行為的是start和opt兩個(gè)子目錄start/插件名vim啟動(dòng)即加載效果等于在線(xiàn)方案里的“默認(rèn)啟用”opt/插件名不會(huì)自動(dòng)加載需要你想要的時(shí)候手動(dòng)執(zhí)行:packadd 插件名才會(huì)加載這個(gè)機(jī)制對(duì)離線(xiàn)環(huán)境極其友好因?yàn)檎麄€(gè)加載過(guò)程根本不涉及任何網(wǎng)絡(luò)操作和倉(cāng)庫(kù)操作只要你的目錄結(jié)構(gòu)正確、vim版本支持插件立刻就能用。它的缺點(diǎn)是更新時(shí)要自己去有網(wǎng)機(jī)器上clone或下載再覆蓋但從來(lái)沒(méi)有人規(guī)定過(guò)離線(xiàn)環(huán)境能接受多高的更新頻率。3.2 一個(gè)能直接用的packpath目錄布局我實(shí)際使用中建議這樣布局~/.vim/ ├── vimrc └── pack/ └── vendor/ ├── start/ │ ├── nerdtree/ │ ├── vim-airline/ │ └── editorconfig-vim/ └── opt/ └── tagbar/對(duì)應(yīng)的vimrc里這樣寫(xiě)set nocompatible packloadall 可選按需加載opt目錄下的插件 nnoremap F9 :packadd tagbarCR:TagbarToggleCRpackloadall會(huì)遍歷所有start/*目錄并將它們加入runtimepath這一步相當(dāng)于把一堆set rtp自動(dòng)完成。對(duì)于opt/下的插件:packadd tagbar命令會(huì)在runtimepath里加入~/.vim/pack/vendor/opt/tagbar然后后續(xù)命令才能調(diào)用它的函數(shù)。有一點(diǎn)要注意某些插件在plugin/目錄里會(huì)執(zhí)行filetype off之類(lèi)的全局設(shè)置多個(gè)插件在一起時(shí)啟動(dòng)順序會(huì)影響行為。一般來(lái)說(shuō)start/里的插件是按文件名字典序加載的如果某個(gè)插件需要另一個(gè)插件先加載比如依賴(lài)某個(gè)函數(shù)就需要把被依賴(lài)的插件目錄名改成00-xxxx這種帶前綴的形式讓它在字典序上排前頭。這算一個(gè)冷門(mén)小技巧但離線(xiàn)排查時(shí)能幫你省半天時(shí)間。3.3 配合help文檔和tags的離線(xiàn)生成packpath方案里的插件目錄是從別的機(jī)器拷貝過(guò)來(lái)的通常帶有doc/目錄但vim的:help命令需要對(duì)應(yīng)的tags文件才能正確跳轉(zhuǎn)。如果你發(fā)現(xiàn):help nerdtree打不開(kāi)或者提示沒(méi)有tags需要自己生成一下vim -u NONE -c helptags ~/.vim/pack/vendor/start/nerdtree/doc -c q這條命令會(huì)讀取doc/下所有.txt文件并生成tags。-u NONE表示不加載用戶(hù)配置-c表示執(zhí)行完命令后退出。批量處理所有插件時(shí)可以寫(xiě)個(gè)循環(huán)for dir in ~/.vim/pack/vendor/start/*/; do vim -u NONE -c helptags $dir/doc -c q done這個(gè)后處理在網(wǎng)絡(luò)正常的機(jī)器上通常由管理器自動(dòng)完成離線(xiàn)手動(dòng)部署時(shí)是回報(bào)率最高的細(xì)節(jié)。你辛辛苦苦拷了一堆插件結(jié)果:help跳轉(zhuǎn)404體驗(yàn)大打折扣。4. 完整實(shí)操?gòu)臏?zhǔn)備到部署的一站式記錄原理說(shuō)清楚了下面是一套可以照抄的完整流程。假設(shè)目標(biāo)是一臺(tái)全新的內(nèi)網(wǎng)CentOS 7機(jī)器沒(méi)有外網(wǎng)要部署vim和一些常用插件。我會(huì)把每一步都展開(kāi)寫(xiě)包括我實(shí)際會(huì)敲的命令和檢查點(diǎn)。4.1 在有網(wǎng)機(jī)器上準(zhǔn)備離線(xiàn)工件我習(xí)慣建一個(gè)vim-offline/目錄把vim的插件倉(cāng)庫(kù)、vim-plug本體、甚至目標(biāo)機(jī)器可能缺的依賴(lài)rpm包都放進(jìn)去。目錄結(jié)構(gòu)如下vim-offline/ ├── autoload/ │ └── plug.vim ├── plugged/ │ ├── nerdtree/ │ ├── vim-airline/ │ ├── ctrlp.vim/ │ ├── vim-fugitive/ │ └── coc.nvim/ ├── vimrc └── deps/ ├── node-v16.20.2-linux-x64.tar.xz └── ctags-5.8-2.el7.x86_64.rpm其中plugged/下的目錄全部來(lái)自有網(wǎng)環(huán)境的:PlugInstall或者用git clone --depth 1拉取。coc.nvim這類(lèi)插件特殊它同時(shí)需要node運(yùn)行時(shí)和它自己內(nèi)部的node模塊。所以我會(huì)在有網(wǎng)環(huán)境下進(jìn)入plugged/coc.nvim目錄執(zhí)行一次npm install把node_modules生成好然后整個(gè)目錄一起打包帶走。這個(gè)細(xì)節(jié)90%的人會(huì)漏掉到了離線(xiàn)機(jī)器上coc.nvim裝好了卻起不來(lái)報(bào)錯(cuò)信息又不直觀。cd vim-offline tar czf vim-offline.tar.gz .打包后把tar文件拷到目標(biāo)機(jī)器/tmp/下。4.2 目標(biāo)機(jī)器解壓與vim版本檢查先確認(rèn)目標(biāo)機(jī)器的vim版本和特性支持vim --version | head -5 vim --version | grep -E python3|ruby|clipboard如果vim版本低于8.0packpath方案就不支持了只能退回vim-plug本地路徑方案。我的經(jīng)驗(yàn)是內(nèi)網(wǎng)CentOS 7默認(rèn)的vim是7.4需要先升級(jí)。這時(shí)你會(huì)遇到熱搜里那句“package vim is not available, but is referred to by another package. this ma”——后面專(zhuān)門(mén)講這里只提醒用yum install vim往往不行需要先確認(rèn)源比CentOS 7默認(rèn)base源里vim相關(guān)包叫vimproved或vim-enhanced直接搜vim這個(gè)名字它反而會(huì)給出這樣的提示。正確的包名通常是vim-enhanced或vim-minimal要裝的是yum install -y vim-enhanced檢查通過(guò)后把離線(xiàn)包解壓到~/.vim對(duì)應(yīng)位置mkdir -p ~/.vim cd ~ tar xzf /tmp/vim-offline.tar.gz因?yàn)閠ar包里的目錄層次就是直接在~/.vim下展開(kāi)的解壓完vim-plug和插件就位。4.3 編寫(xiě)vimrc與加載驗(yàn)證目標(biāo)機(jī)器上的~/.vimrc內(nèi)容基于打包帶過(guò)去的vimrc核心部分長(zhǎng)這樣call plug#begin(~/.vim/plugged) Plug ~/.vim/plugged/nerdtree Plug ~/.vim/plugged/vim-airline Plug ~/.vim/plugged/ctrlp.vim Plug ~/.vim/plugged/vim-fugitive Plug ~/.vim/plugged/coc.nvim, {do: { - coc#util#install() }} call plug#end()這里每一個(gè)Plug都指向本地路徑即使斷網(wǎng)vim-plug也不會(huì)聯(lián)網(wǎng)。插句話(huà)說(shuō)coc.nvim的do聲明會(huì)在:PlugInstall時(shí)執(zhí)行安裝腳本如果coc相關(guān)目錄里已經(jīng)帶有預(yù)構(gòu)建產(chǎn)物腳本會(huì)很快結(jié)束。然后啟動(dòng)vimvim在vim里執(zhí)行:scriptnames這個(gè)命令會(huì)列出所有vim啟動(dòng)時(shí)加載的腳本文件路徑。檢查列表里是否包含~/.vim/plugged/nerdtree/plugin/NERD_tree.vim這樣的路徑。如果能看到說(shuō)明插件加載成功。另外可以執(zhí)行:PlugStatusvim-plug會(huì)列出所有聲明的插件狀態(tài)OK表示路徑找到且已加載。4.4 把依賴(lài)的二進(jìn)制工具一并部署很多vim插件號(hào)稱(chēng)“純vim實(shí)現(xiàn)”裝完就完事。但真實(shí)世界的知名插件基本都帶二進(jìn)制依賴(lài)。你自己統(tǒng)計(jì)一下就會(huì)發(fā)現(xiàn)出問(wèn)題的插件基本都栽在依賴(lài)上插件依賴(lài)離線(xiàn)準(zhǔn)備方式ctrlp.vimvim自帶無(wú)需額外處理vim-airline字體可選拷貝powerline字體到系統(tǒng)字體目錄coc.nvimnode.js 16下載node二進(jìn)制tar包解壓到/optvim-fugitivegit系統(tǒng)自帶或離線(xiàn)rpm安裝tagbarctags下載rpm包yum localinstallfzffzf二進(jìn)制預(yù)先在有網(wǎng)機(jī)器上編譯好拷過(guò)去YouCompleteMecmake, gcc, python-dev在有網(wǎng)機(jī)器上編譯完整個(gè)ycm_core拿node舉例從nodejs.org下載node-v16.20.2-linux-x64.tar.xz目標(biāo)機(jī)器上解壓到/opt/node然后在~/.bashrc里加一行export PATH/opt/node/bin:$PATH檢測(cè)是否成功node --version注意coc.nvim還要檢查node能跑起來(lái)才算數(shù)因?yàn)樗诓寮?nèi)部會(huì)啟動(dòng)node進(jìn)程做語(yǔ)言服務(wù)。5. 常見(jiàn)報(bào)錯(cuò)與避坑手冊(cè)這部分全是真金白銀的踩坑總結(jié)。我按出現(xiàn)頻率從高到低列每一條都是我在離線(xiàn)環(huán)境里實(shí)際碰到的。5.1 “package vim is not available, but is referred to by another package”這串提示到底啥意思熱搜里這個(gè)片段的完整版一般長(zhǎng)這樣Package vim is not available, but is referred to by another package. This may mean that the package is missing, has been obsoleted, or is only available from another source在Debian系系統(tǒng)比如Ubuntu、Debian里運(yùn)行apt install vim時(shí)出現(xiàn)通常是apt源列表里沒(méi)有vim這個(gè)包名對(duì)應(yīng)的可用條目。可能的原因有幾個(gè)系統(tǒng)的/etc/apt/sources.list配置不完整或者源文件里的地址是內(nèi)網(wǎng)/舊地址apt update沒(méi)成功系統(tǒng)太老或太精簡(jiǎn)包源里vim的元數(shù)據(jù)沒(méi)拉到你用的是最小化容器鏡像里面根本沒(méi)有配置desktop相關(guān)的源我的處理順序是cat /etc/apt/sources.list apt update apt policy vimapt policy vim會(huì)顯示源里vim包的候選版本。如果輸出沒(méi)有任何候選基本確定是源的問(wèn)題建議參考同版本發(fā)行版官方源重新配置后再apt update。CentOS系則用yum search vim或yum list available vim*通常包名是vim-enhanced。這兩個(gè)系統(tǒng)恰好都容易在“vim這個(gè)名字”上栽跟頭原因就是發(fā)行版里vim主包被拆分成了不同名字。我見(jiàn)過(guò)有人為了繞過(guò)這個(gè)問(wèn)題從網(wǎng)上隨手找個(gè)rpm包rpm -ivh強(qiáng)裝結(jié)果依賴(lài)沖突一堆把系統(tǒng)搞壞。建議別這么干優(yōu)先修源。5.2 插件文件在但vim完全沒(méi)加載檢查runtimepath和suffixes癥狀是插件明明拷貝到位了打開(kāi)vim一點(diǎn)效果沒(méi)有。排查步驟按順序來(lái)第一步:set runtimepath?看輸出里有沒(méi)有插件路徑。沒(méi)有的話(huà)說(shuō)明你的加載步驟沒(méi)執(zhí)行vim-plug需要plug#begin/end包裹packpath需要packloadall。第二步:filetype plugin indent on有些插件依賴(lài)filetype插件比如ftplugin/里的文件。如果你的vimrc里沒(méi)有這條vim根本不會(huì)去加載ber文件類(lèi)型插件。第三步確認(rèn)插件目錄里是不是真的存在plugin/子目錄。有些插件是lazy-load設(shè)計(jì)比如編輯器需要輸入特定命令才加載主腳本。遇到這種別說(shuō)“沒(méi)反應(yīng)”試著輸入插件提供的命令比如NERDTree就敲:NERDTree。另一個(gè)冷門(mén)癥狀.vimrc里如果用了set suffixes...之類(lèi)全局配置雖然不至于讓插件不加載但會(huì)影響文件搜索優(yōu)先級(jí)。這類(lèi)配置多了排查插件問(wèn)題時(shí)容易混淆。5.3 插件報(bào)錯(cuò)但原因不直觀老版本vim與腳本語(yǔ)法不兼容離線(xiàn)機(jī)器上vim版本老插件又是新寫(xiě)法最容易出現(xiàn)無(wú)語(yǔ)的兼容性問(wèn)題。比如vim-airline最新版用了trim()這種較新函數(shù)在Vim 7.4上直接E118。我的經(jīng)驗(yàn)是給離線(xiàn)機(jī)器配插件時(shí)盡量選擇與目標(biāo)vim版本匹配的插件版本。最靠譜的做法是在有網(wǎng)機(jī)器上先查看一個(gè)插件的tag列表拉取release分支。比如vim-plug可以這樣指定版本Plug vim-airline/vim-airline, { tag: v0.11 }離線(xiàn)環(huán)境下用--depth 1 --branch v0.11去clone對(duì)應(yīng)tag。這樣避免最新版本和舊vim不兼容的問(wèn)題。否則你會(huì)花大量時(shí)間去改別人插件的源碼得不償失。5.4 不同插件管理器的差異遷移從vim-plug遷移packpath時(shí)很多人會(huì)犯一個(gè)錯(cuò)直接在vimrc里寫(xiě)packadd xxx但packadd只對(duì)opt/目錄里的插件有效。如果插件在start/里且packloadall已經(jīng)執(zhí)行過(guò)它會(huì)自動(dòng)加載你再手動(dòng)packadd反而會(huì)提示“找不到包”。這屬于理解了機(jī)制就順理成章的事但教程看多了反而容易搞反。對(duì)比一下VSCode的離線(xiàn)安裝思路比如把.vsix文件拷進(jìn)extensions目錄和vim的packpath本質(zhì)上是一樣的哲學(xué)插件本質(zhì)是文件管理器只是負(fù)責(zé)把一個(gè)文件路徑注冊(cè)進(jìn)運(yùn)行時(shí)的搜索路徑。理解了這一層你遷移到Neovim的packer.nvim或者lazy.nvim思路也是通的只不過(guò)lazy.nvim多了一層lua配置語(yǔ)法和更嚴(yán)格的加載順序描述。6. 最后分享幾點(diǎn)實(shí)際經(jīng)驗(yàn)離線(xiàn)安裝這件事我前前后后折騰了無(wú)數(shù)次最后總結(jié)出幾條經(jīng)驗(yàn)。第一不要追求把有網(wǎng)環(huán)境的整套vim配置原樣搬到離線(xiàn)機(jī)器上。插件越多依賴(lài)越多某一步不一致整個(gè)環(huán)境就崩。我給離線(xiàn)機(jī)器做配置時(shí)會(huì)刻意砍掉可能依賴(lài)外部linter的插件比如ale、vimspector這類(lèi)只保留純vim腳本實(shí)現(xiàn)的插件實(shí)測(cè)穩(wěn)定得多。第二一定要在你打包的環(huán)境里完整驗(yàn)證一遍。很多依賴(lài)問(wèn)題是隱性的你有網(wǎng)環(huán)境里裝過(guò)一次、node_modules早就存在你覺(jué)得沒(méi)問(wèn)題但拷貝過(guò)去的目錄如果少了一個(gè)符號(hào)鏈接或者目錄權(quán)限是700而不是755隔離機(jī)器上就會(huì)出詭異故障。我有個(gè)小習(xí)慣打包前先把.git目錄刪掉或者用--depth 1克隆因?yàn)槿靠寺〉?git體積非?？捎^而且離線(xiàn)環(huán)境里你也不大可能執(zhí)行g(shù)it pull。刪了之后整個(gè)目錄能縮小好幾倍拷貝起來(lái)更快。第三養(yǎng)成記錄vim版本的習(xí)慣。離線(xiàn)環(huán)境下最怕的就是“你覺(jué)得有實(shí)際沒(méi)有”。我每次部署都會(huì)先寫(xiě)清楚目標(biāo)機(jī)器的vim --version、python3 -V、node -v再對(duì)著這個(gè)清單準(zhǔn)備插件和依賴(lài)。這個(gè)清單比任何管理器都好使因?yàn)椴寮芾砥髦荒芄懿寮懿涣四愕南到y(tǒng)環(huán)境。離線(xiàn)裝vim插件本質(zhì)不復(fù)雜文件名對(duì)上路徑加載上依賴(lài)備齊就這三件事。把這套思路想明白不僅vim能用VSCode離線(xiàn)裝插件、WSL離線(xiàn)裝環(huán)境、甚至Docker鏡像離線(xiàn)導(dǎo)入底層都是同一個(gè)道理——把網(wǎng)絡(luò)環(huán)節(jié)去掉剩下的就是個(gè)文件拷貝和路徑注冊(cè)的工程問(wèn)題。下次再有人問(wèn)我離線(xiàn)環(huán)境怎么配我大概會(huì)把這篇文章甩給他然后補(bǔ)一句“先別急著找包先把vim版本看清楚?！?