为何使用不同API查询Neovim的runtimepath结果不同？

核心原因 #

Neovim 0.8.1版本中，vim.api.nvim_list_runtime_paths()和Vimscript的:set runtimepath?行为存在明确差异：

• :set runtimepath?显示的是预设的完整runtimepath模板列表，包含Neovim默认配置的所有可能路径（比如~\AppData\Local\nvim），无论这些目录是否实际存在。
• vim.api.nvim_list_runtime_paths()返回的是已经被实际加载到runtimepath的路径，只有当目录存在、或者有配置文件触发了该路径的加载时，才会被包含进来。

你的场景中，~\AppData\Local\nvim目录不存在（未使用任何自定义配置），所以nvim_list_runtime_paths()不会返回它，而:set runtimepath?依然会显示这个预设路径。这直接导致你无法通过XDG_CONFIG_HOME加载配置——因为对应的目录未被加入实际的runtimepath。

解决方法 #

1. 创建默认配置目录
   手动创建%USERPROFILE%\AppData\Local\nvim目录，或者在该目录下创建init.vim/init.lua文件（哪怕是空文件）。Neovim启动时会自动检测到该目录，并将其加入runtimepath，此时vim.api.nvim_list_runtime_paths()就会包含这个路径，XDG_CONFIG_HOME对应的配置也能正常加载。

2. 手动添加runtimepath（Lua方式）
   如果需要在配置中手动指定路径，可以执行：

   -- 添加默认的XDG配置目录到runtimepath
   vim.opt.runtimepath:append(vim.fn.expand('$USERPROFILE/AppData/Local/nvim'))
   -- 若已设置XDG_CONFIG_HOME环境变量，改用以下命令
   -- vim.opt.runtimepath:append(vim.fn.expand('$XDG_CONFIG_HOME/nvim'))
   

3. 升级Neovim版本
   Neovim 0.9及以上版本修复了这个API行为差异，vim.api.nvim_list_runtime_paths()会返回完整的默认runtimepath列表，无论目录是否存在。如果允许升级，这是最彻底的解决方式。

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