ncm2 - 更加专注 & 可拓展的 vim/neovim 代码补全框架

ncm2/ncm2 的前身是 roxma/nvim-completion-manager (ncm)

为了更加可拓展，更加专注于代码补全，清理历史遗留代码，我重写了 ncm。部分变化列举如下：

原本内置的 sources，snippet 集成，还有 subscope 代码检测全部移出 ncm2 repo，作为独立插件维护。ncm2 本身的代码更少，更加独立可拓展和可维护。
引入 roxma/nvim-yarp，ncm2 不再管理异步进程。source 插件可以自由选择异步模型，对 vimscript 配置更加灵活友好，对异步操作的性能提升也更有帮助。
清理代码过程中发现了一些更加干净，简单的内部实现
- 比如移除了定时器逻辑，优化了缓存逻辑
- 比如 completeopt 更加灵活可配置
- 对 unicode 字符更加友好

以上主要是实现上的变化，作为插件使用者应该感受不太清晰，以下列举一些更容易看得见的变化：

Language Server Protocol 方面
- 优化了对 autozimu/LanguageClient-neovim 集成的 snippet 支持，效果近乎完美（参数展开，auto import ）。理论上可以自由选择你喜欢的 vim snippet 引擎，比如已经支持的 Ultisnips，和 vim-snipmate。
- 新增加对 vim-lsp 补全功能的集成。snippet 支持同上。
更加好用的 fuzzy 匹配，目前有 abbrfuzzy 和 substrfuzzy
我日常写 C/C++ 比较多，所以基于 libclang 写了一个补全插件 ncm2-pyclang ，因为有了缓存，所以速度表现会比基于 clang -cc1 实现的 [ncm-clang]( https://github.com/roxma/ncm-clang] 更好，并且支持 goto declaration 和头文件不全。后续还有更多的优化计划。

相关资源可以在 README 和 wiki 页面查找

Gif demo:

Yggdroot

2018-08-03 11:24:20 +08:00

试用了一下，感觉还不错，说说使用中遇到的问题。
1. 在 vim 中，还没使用成功。
一启动就有错
```
Error detected while processing function ncm2#insert_mode_only_key:
line 3:
E492: Not an editor command: tmap <Plug>(ncm2_skip_auto_trigger) <nop>
E492: Not an editor command: tmap <Plug>(ncm2_auto_trigger) <nop>
E492: Not an editor command: tmap <Plug>(ncm2_manual_trigger) <nop>
E492: Not an editor command: tmap <Plug>(ncm2_complete_popup) <nop>
E492: Not an editor command: tmap <Plug>(_ncm2_auto_trigger) <nop>
```
我 vimrc 中只是 https://github.com/ncm2/ncm2#install 里面的内容，后来又加上了 Plug 'roxma/vim-hug-neovim-rpc'。
tmap 是 neovim 中的命令，在启动 vim 时却报这个错。（怀疑楼主所说的支持 vim 只是理论上，实际上没测过）

2. 不够 `out of box`
我把 https://github.com/ncm2/ncm2#install 里的内容添加到 vimrc 里，启动 nvim，发现怎么操作都没有补全；后来猜测可能需要装一些 source，就装了 Plug 'ncm2/ncm2-bufword'，敲了几个字母，发现还是没有补全；等敲到第 4 个字母时，才弹出了补全菜单，我一般习惯于 1 个字母就出现补全。我知道这可以设置，就找到了 g:ncm2#complete_length。
当然这都不是什么问题，我觉得如果 readme 里加一些必要的说明会更好，这样可以让像我这样第一次接触 ncm2 的人能够更容易的去体验这个插件。

3. fuzzy 算法有待提高
补全只能识别单词的边界字母，非边界字母就识别不了了。
例如：`encode`, 如果我输入`end`，`encode`就不会出现在补全列表中了。

总体来说还不错，不像一些插件补全菜单闪的厉害，会继续试用。

pony279

2018-08-03 12:00:56 +08:00

> tmap 是 neovim 中的命令，在启动 vim 时却报这个错。（怀疑楼主所说的支持 vim 只是理论上，实际上没测过）

tmap 在新版的 vim8 也有了，我测试的版本是 8.1.135 http://vimhelp.appspot.com/map.txt.html#%3Atmap

> 敲了几个字母，发现还是没有补全；等敲到第 4 个字母时，才弹出了补全菜单，我一般习惯于 1 个字母就出现补全。我知道这可以设置，就找到了 g:ncm2#complete_length。

这个还真是个人习惯，我喜欢稍微安静一些的 popup，每敲击一个字符就弹出会很烦

> 里的内容添加到 vimrc 里，启动 nvim，发现怎么操作都没有补全

source 在 README Optional tips 里面有。也许应该移到 Install 部分会比较显眼吧。

> 3. fuzzy 算法有待提高

这个是有意而为之

在旧版本的 ncm 里面有一个 fuzzy matcher 能符合你的描述： https://github.com/roxma/nvim-completion-manager/blob/master/pythonx/cm_matchers/fuzzy_matcher.py

可是它太过 fuzzy。后来我发现需要过滤的条数越多，得到的结果精准度就越差，到最后我自己又用回了 prefix match

基于之前的体验，我重新开发了两种 fuzzy，目前默认是 abbrfuzzy，换成最近新增的 substrfuzzy 可能会更加符合你的习惯

你可以在这里参与讨论 https://github.com/ncm2/ncm2/issues/30，主要是反馈太少，对算法的描述也比较困难，所以大多基于自己的喜好和体验去实现和优化

ivechan

2018-08-04 19:35:50 +08:00

@pony279 一个很奇怪的问题，在补全 python 的第三方包 mxnet 的时候，会出现错误，其他包没有问题。
windows
neovim 0.3.2 dev
python 3.6.6
已经安装好插件(确认了其他包补全正常),

复现过程:
pip install mxnet
import mxnet
mxnet.sym.

这步开始出错，使用其他补全工具不会。
出错日志有点长，有需要我再贴上来。

nG29DOMuRYTWfcSr

2018-08-05 14:13:17 +08:00

对于 Vim 插件的开发者，我一至很佩服，前段时间在 reddit 上看到 ncm2 的帖子，跳到 ncm2 github 仓库留言了下，发现还是被作者 block 了，以前的事情过去这么久，这结一直解不开吗？

@pony279 希望，有机会可以聊聊。关于以前你的另外一个插件的一些言论，我先在这里和你道歉。

ivechan

2018-08-05 22:03:47 +08:00

@pony279 你给的链接，我无法重现这个错误。
不过今天我又重新试了一下，发现使用其他包的时候，居然也会出错。
然后我看错误日志，发现居然传递了之前测试 mxnet 包的补全信息，有点匪夷所思。（会不会有缓存机制？）
-----------------------------------------------------------------------------------------------------
我重装了 mxnet 包后，能过正常使用 ncm2 了。
（之前使用 jedi.vim 的时候能过补全 mxnet，就没有怀疑这个包本身的问题）
虽然很意外，不能确定哪里出了问题。不过最终还是顺利用上了 ncm2, 综合使用很不错，很感谢你！