Vim 編輯 UTF-8 文件出現亂碼,核心原因在於四個編碼相關選項 (encoding、fileencoding、fileencodings、termencoding) 配置不匹配。本文深度解析四大選項作用、交互邏輯,提供生產環境通用的最佳配置方案。
| 選項 | 作用域 | 說明 | 修改時機 |
|---|---|---|---|
encoding (enc) | Vim 內部 | Vim 內部所有緩衝區、寄存器、變量使用的編碼,**啟動時一次性設置**,運行期修改極危險 | .vimrc 中設置 |
fileencoding (fenc) | 當前文件 | 當前編輯文件的磁盤存儲編碼,讀取時自動檢測並設置,寫入時按此編碼保存 | 打開文件後自動設置 |
fileencodings (fencs) | 全局檢測 | 打開文件時**按順序嘗試**的編碼列表,第一個解碼成功即採用,順序極關鍵 | .vimrc 中設置 |
termencoding (tenc) | 終端顯示 | Vim 向終端輸出時的編碼轉換目標,未設置則直接用 encoding 輸出 | .vimrc / 運行時動態調整 |
" === 核心編碼設置 ===
set encoding=utf-8 " 內部編碼統一 UTF-8 (最強表現力)
set fileencoding=utf-8 " 新建文件默認保存為 UTF-8
set fileencodings=ucs-bom,utf-8,cp936,gb18030,big5,euc-jp,euc-kr,latin1
set termencoding=utf-8 " 圖形界面 GVim 無效,終端建議 utf-8
" === 中文菜單/提示防亂碼 (Windows GVim) ===
set langmenu=zh_CN.UTF-8
language message zh_CN.UTF-8
" === 可選:根據終端動態調整 termencoding ===
" if &term =~ '^screen\|^xterm\|^rxvt'
" set termencoding=utf-8
" elseif has('win32')
" set termencoding=cp936
" endif
原則: 嚴格編碼前置,寬鬆編碼後置,避免寬鬆編碼「搶佔」解碼權導致誤判。
若自動檢測失敗,已知文件編碼時:
:e ++enc=utf-8 filepath
:e ++enc=gbk filepath
:saveas ++enc=utf-8 newfile.txt " 轉碼保存
termencoding 固定為 utf-8,不可修改termencoding,直接用系統 API 渲染 Unicode:set enc? fenc? fencs? tenc? 查看當前四值:scriptnames 確認 .vimrc 載入順序 (後載入覆蓋先載入):verbose set enc? 查看 encoding 最後被哪裡設置file -i filename / enca -L zh_CN filenamelocale、echo $LANG、終端軟件設置Vim 編碼亂碼 90% 源於 fileencodings 順序不當或 encoding 非 UTF-8。確立 內部 UTF-8、檢測列表嚴格優先、終端匹配 三原則,配合 ++enc 臨時指定應對異常文件,可覆蓋 99% 中文編輯場景。建議將上述推薦配置寫入 ~/.vimrc 一勞永逸。