Neovim自动补全功能会查找哪些位置？

一、内置Omni补全（Ctrl-x-o）的路径逻辑 #

Ctrl-x-o触发的是Neovim的omnifunc补全，不同语言的补全逻辑由对应文件类型插件实现，路径查找规则分语言来看：

1. C/C++ 补全（默认omnifunc: ccomplete#Complete） #

默认C/C++补全会查找这些位置：

• 系统标准头目录：比如/usr/include、/usr/local/include
• 当前缓冲区已打开的头文件所在路径
• &path选项配置的目录：用:set path?能查看当前配置，默认包含当前目录及所有子目录（.,**）
• 注意：默认补全不会自动识别项目Makefile/CMakeLists里的-I编译参数，得手动配置路径

你之前PEGTL放在非标准路径时，不在上述默认范围里，所以补全没反应，移到/usr/local/include（系统标准目录）就被识别到了。

2. Python/Django 补全（默认omnifunc: pythoncomplete#Complete） #

默认Python补全的查找路径：

• 当前Python环境sys.path包含的所有路径（包括标准库、site-packages）
• 当前缓冲区所在目录
• &path配置的目录

Django补全失效，大概率是这两个原因：要么Django安装路径不在当前Neovim用的Python环境sys.path里，要么默认的pythoncomplete#Complete对Django这类框架的补全支持有限——默认补全只认已导入的符号和标准库，对Django的模型、视图这类框架专属符号没做适配。

二、解决方法 #

针对C/C++非标准头目录 #

• 手动把路径加到&path里：比如执行:set path+=/path/to/pegtl/include，要持久化的话就把这行写到~/.config/nvim/init.vim或init.lua里
• 换用LSP类补全插件：比如clangd配合nvim-lspconfig，这类插件能自动读取项目的compile_commands.json（CMake或make可以生成），自动识别所有头文件路径，不用手动配置

针对Django补全 #

• 先确认Django和Neovim用的是同一个Python环境：在Neovim里执行:!which python和:!pip show django，看输出的路径是否匹配
• 换用专门的Python补全插件：比如jedi-vim或者pyright（通过nvim-lspconfig配置），这些插件对Django的框架符号有专门支持，补全更精准
• 手动把Django项目根目录加到sys.path：可以在Neovim的Python配置里加sys.path.append('/path/to/your/django/project')，或者在项目根目录建.nvimrc文件单独配置

三、补充 #

Neovim内置补全的逻辑比较基础，要是你做复杂项目（比如大型C++工程、Django项目），更推荐用基于LSP的补全方案——这类方案能深度整合项目配置和依赖，补全效果比内置的omnifunc好太多。

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