Neovim在init.lua中如何正确设置vimwiki_list及同类插件全局选项

配置触发的一连串Vim报错，核心是两个和插件预期不匹配的问题：

• 数据结构不匹配：vimwiki_list在插件逻辑中被强制要求为列表类型，列表的每一项存储单个wiki的配置字典。之前配置传入的是单层字典，没有外层的列表结构，插件读取时直接触发E714: List required的类型校验错误。
• 必要参数缺失：传入的配置字典没有补全syntax、ext两个必填参数，后续插件遍历读取文件扩展、语法配置时，因目标值不存在就会触发E727: Start past end的越界类报错。

对照官方提供的Vimscript配置结构，转到Lua环境时只需要严格匹配对应的数据类型即可，基础写法如下：

-- 等效官方Vimscript配置的Lua实现
vim.g.vimwiki_list = {
  {
    path = '~/vimwiki/',
    syntax = 'markdown',
    ext = '.md'
  }
}

如果需要配置多个独立的wiki仓库，只需要在外层列表里追加对应的配置字典即可，例如：

-- 多wiki场景配置示例
vim.g.vimwiki_list = {
  {
    path = '~/work-notes/',
    syntax = 'markdown',
    ext = '.md',
    name = '工作知识库'
  },
  {
    path = '~/daily-record/',
    syntax = 'markdown',
    ext = '.md',
    name = '日常随笔'
  }
}

所有基于传统Vimscript开发的插件，读取的全局配置本质都是Neovim的全局变量（对应Vimscript语法中的g:xxx变量）。在Lua中配置这类选项时，只要遵循Lua和Vim的数据类型映射关系，就不会频繁出现类型类报错：

• Lua中使用连续数字索引的表（即原生数组结构），会自动转换为Vimscript的列表（List）
• Lua中使用字符串作为键的表，会自动转换为Vimscript的字典（Dictionary）
• 如果插件要求配置项为列表类型，哪怕列表里只有一个元素，也必须在外层套一层数组结构，不能直接传字典
• 配置全局变量时，vim.g.变量名 = 对应值的写法和原生APIvim.api.nvim_set_var('变量名', 对应值)完全等效，语法更简洁，日常配置更推荐使用前者

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