Ubuntu WSL中Neovim启动报错求助（AppImage安装）

问题背景 #

在Ubuntu WSL环境中，因apt安装的Neovim版本过旧，通过AppImage安装最新版，执行命令：

curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim.appimage
chmod u+x nvim.appimage
./nvim.appimage

参考博客配置packer等工具后，启动Neovim时出现大量Lua相关报错，核心报错栈：

Error detected while processing /home/rr/.config/nvim/init.lua:
E5113: Error while calling lua chunk: /home/rr/.config/nvim/lua/vars.lua:4: attempt to index local 'g' (a function value)
stack traceback:
        /home/rr/.config/nvim/lua/vars.lua:4: in main chunk
        [C]: in function 'require'
        /home/rr/.config/nvim/init.lua:10: in main chunk
...（其余报错略）

当前配置结构：

.config/nvim/
├── init.lua
├── lua
│   ├── keys.lua
│   ├── opts.lua
│   ├── plug.lua
│   └── vars.lua
└── site
    └── pack
        └── packer

核心配置文件：

init.lua #

--[[ init.lua ]]

-- LEADER
-- These keybindings need to be defined before the first
-- is called; otherwise, it will default to "\"
vim.g.mapleader = ","
vim.g.localleader = "\\"

-- IMPORTS
require("vars")      -- Variables
require('opts')      -- Options
require('keys')      -- Keymaps
require('plug')      -- Plugins

plug.lua #

-- [[ plug.lua ]]

return require("packer").startup(function(use)
    use "wbthomason/packer.nvim"
    use "nvim-tree/nvim-tree.lua"
end
)

vars.lua（错误版本） #

--[[ vars.lua ]]
vim.g = vim.api.nvim_set_var
local g = vim.g
g.t_co = 256
g.background = "dark"

-- Update the packpath
local packer_path = vim.fn.stdpath("config") .. "/site"
vim.o.packpath = vim.o.packpath .. "," .. packer_path

错误原因 #

问题出在vars.lua的第一行：

vim.g = vim.api.nvim_set_var

这行代码完全覆盖了Neovim内置的vim.g全局变量表，把它从一个用于存储全局变量的表，替换成了vim.api.nvim_set_var这个函数。后续所有试图通过vim.g.xxx（或通过local g=vim.g后访问g.xxx）索引变量的操作都会失败，因为函数不能被用.索引——这就是报错里"attempt to index local 'g' (a function value)"的原因，而且这个错误会影响Neovim自身的runtime文件（比如filetype.lua、man.lua等），导致连锁报错。

修复步骤 #

修改vars.lua，移除错误的赋值语句，正确设置全局变量：

修改后的vars.lua（推荐写法） #

--[[ vars.lua ]]
local g = vim.g
g.t_co = 256
g.background = "dark"

-- Update the packpath
local packer_path = vim.fn.stdpath("config") .. "/site"
vim.o.packpath = vim.o.packpath .. "," .. packer_path

也可以直接使用vim.g赋值，无需定义局部变量：

--[[ vars.lua ]]
vim.g.t_co = 256
vim.g.background = "dark"

-- Update the packpath
local packer_path = vim.fn.stdpath("config") .. "/site"
vim.o.packpath = vim.o.packpath .. "," .. packer_path

如果想使用vim.api.nvim_set_var，正确用法是调用函数而非赋值给vim.g：

--[[ vars.lua ]]
vim.api.nvim_set_var("t_co", 256)
vim.api.nvim_set_var("background", "dark")

-- Update the packpath
local packer_path = vim.fn.stdpath("config") .. "/site"
vim.o.packpath = vim.o.packpath .. "," .. packer_path

验证 #

修改完成后，重新执行./nvim.appimage启动Neovim，报错应该消失，配置可正常加载。

内容的提问来源于stack exchange，提问作者K Y