Neovim启动报E117错误：plug#begin/end函数未知，求完整配置步骤

问题原因 #

启动时的E117报错，是因为你在配置里调用了plug#begin()和plug#end()，但没有安装对应的插件管理器vim-plug——这两个函数是vim-plug提供的，未安装时自然会提示“未知函数”。

一、先解决报错：安装vim-plug #

macOS/Linux 终端执行安装命令 #

sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
       https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'

这条命令会把vim-plug的核心文件下载到Neovim的自动加载目录，重启Neovim后报错就会消失。

二、完整Neovim配置流程 #

1. 确认配置目录存在 #

Neovim的默认配置目录是~/.config/nvim/，如果不存在就创建：

mkdir -p ~/.config/nvim/

2. 编写init.vim配置文件 #

配置文件的核心结构分为三部分：插件管理器初始化、插件列表、个性化配置。示例：

" 初始化vim-plug，指定插件安装目录
call plug#begin('~/.config/nvim/plugged')

" 这里添加你需要的插件，格式为 Plug 'GitHub作者名/仓库名'
" 示例插件：
Plug 'nvim-treesitter/nvim-treesitter'  " 语法高亮
Plug 'nvim-tree/nvim-tree.lua'          " 文件管理器
Plug 'tpope/vim-fugitive'               " Git集成

call plug#end()

" 以下是个性化配置和插件设置
" 基础编辑器配置
set number              " 显示行号
set relativenumber      " 开启相对行号
set autoindent smartindent  " 智能自动缩进
set mouse=a             " 启用全局鼠标支持
set encoding=utf-8      " 设置编码为UTF-8
set hlsearch incsearch  " 搜索高亮+增量搜索

" 插件快捷键配置
nnoremap <C-n> :NvimTreeToggle<CR>  " Ctrl+n 打开/关闭文件管理器

3. 安装插件 #

打开Neovim，执行命令：

:PlugInstall

等待所有插件下载安装完成后，重启Neovim即可生效。

4. 后续维护插件 #

• 更新插件：:PlugUpdate
• 清理未使用的插件：:PlugClean

三、常见问题排查 #

• 如果仍出现plug相关错误：检查~/.local/share/nvim/site/autoload/plug.vim文件是否存在，路径是否正确。
• 插件安装失败：检查网络连接，或者手动克隆插件仓库到~/.config/nvim/plugged/目录下。

内容的提问来源于stack exchange，提问作者Sergio Bost