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