CodeBuddy 代码补全（使用指南）

一、概述

在编辑器内编辑代码文件时，CodeBuddy 会在合适时机和位置自动触发智能代码补全提示，而且会有代码补全推荐时的文字引导，可以按照文字引导进行操作。

三、禁用和启用补全功能

单击状态栏的 CodeBuddy 小图标，在顶部下拉选项中可以启用或者禁用代码补全功能。

在禁用补全功能时，支持全局禁用和对特定的代码语言进行禁用。CodeBuddy 自动识别当前打开的文件的代码语言，展示在顶部下拉框中供你选择。

四、默认快捷键

实际快捷键配置请在应用内查看。

五、补全 Pro 能力

补全 Pro 能力，不仅可以对当前光标处的代码进行补全，也可以对其它相关地方的代码进行补全，即预测开发者接下来要写的代码，并提前给出建议，具有“前瞻性”的核心特点，实现更好的补全效果。

六、禁用和启用补全功能

在菜单 > 高级设置中配置：

该能力默认为开启状态，支持自动触发和手动触发，手动触发的快捷键为 Ctrl + Shift + Enter。

七、修改变量名的补全 Pro 场景

修改变量名后，根据光标的移动，以及代码情况，捕捉到上下文信息后，在合理的光标位置出现补全推荐。

八、修改函数或方法名的补全 Pro 场景

函数或方法名修改后，在引用处，通过光标的定位，自动触发补全 Pro 。

十、禁用和启用补全功能

单击状态栏的 CodeBuddy 小图标，可以启用或者禁用 CodeBuddy 代码自动补全功能。

十一、默认快捷键

实际快捷键配置请在应用内查看。

十三、禁用和启用智能补全功能

单击状态栏的 CodeBuddy 小图标，在弹出的菜单选项里可以启用或者禁用 CodeBuddy 代码补全功能。

十四、默认快捷键

实际快捷键配置请在应用内查看。

十五、补全 Pro 能力

补全 Pro 能力，即 NES （Next Edit Suggestions），不仅可以对当前光标处的代码进行补全，也可以对其它相关地方的代码进行补全，即预测开发者接下来要写的代码，并提前给出建议，具有“前瞻性”的核心特点，实现更好的补全效果。

十六、禁用和启用补全功能

在菜单 > 打开设置中配置：

默认为开启状态，支持自动触发和手动触发，手动触发的快捷键为 Ctrl + Shift + Enter。

在底部状态栏中单击 CodeBuddy 小图标，在弹出的菜单选项里可以选择启用或禁用 NES：

十七、修改函数或修改方法名的补全 Pro 场景

修改变量名后，根据光标的移动位置，以及代码情况，捕捉到上下文信息后，在合理的光标位置出现补全推荐。

十八、修改函数或方法名的补全 Pro 场景

函数或方法名修改后，在引用处，通过光标的定位，自动触发 NES。

十九、代码补全触发时机

CodeBuddy 会根据光标所在位置选择合适的位置进行代码补全，例如当光标位置在代码行尾附近位置，或者换行的时候才会触发代码补全。以 VS Code 为例 （JetBrains IDE 同理）。

·行尾右边小括号前面位置触发补全。

·行尾右边大括号前面位置触发补全。

·代码行尾位置触发补全。

·代码换行位置触发补全。

20、代码补全内容的粒度

实际使用过程中，CodeBuddy 补全内容的粒度在不同的代码位置是不一样的。实验发现，并不是补全的内容越多越好（可能补全的越多，错的越多，而且速度也会变慢，补全内容的长度与补全所需要的时间成正比），在不同代码位置，补全的内容的多少（粒度）是不一样的。例如在一个空的代码块中，CodeBuddy 则按代码块粒度进行补全；在非空代码块中，大部分情况按单行粒度进行补全；在类定义块中，或者顶级块中，就算块内不为空，也按代码块粒度进行补全。以 VS Code 为例（JetBrains IDE 同理）。

·光标在方法或者函数体内，且体内为空，按块补全。

·光标在语句内，例如 for 语句、try 语句等，且体内为空，按块补全。

·光标在语句内，例如 for 语句、try 语句等，且体内不为空，则按单行补全。

·光标在方法或者函数体内，且体内不为空，按单行补全。

·光标在类定义体内，按块补全。

·光标在一行代码尾部范围，则按单行补全。

21、提升代码补全结果的正确性

代码补全结果的正确性是相对当前开发者来说的，对 CodeBuddy 来说可能是正确合理的，但是对当前开发者来说可能不正确、不合理。为了帮助你理解，可以把代码补全功能，想象成一个隐藏在背后的程序员：

·它的眼睛几乎只能看到当前光标之前的代码（代码行数和字符数也是有一定限制的）。

·具有较强的逻辑推理和模仿能力。

·它只能接着当前光标位置继续完成后续的代码。

所以，从上面三个特性就能很容易推出可以通过使用光标之前的代码引导它帮助我们写出更为正确的后续代码。引导的方式有很多种，如下所示：

1. 通过代码注释直接告诉它，我想要做什么，例如实现一个冒泡排序。

2. 通过已有平级同类型代码，引导出可能的补全内容，例如用户模块的 CRUD 功能实现，通过实现 CRU，引导它模仿 CRU 的实现方式，实现 D 功能。

3. 让自己的代码有迹可循，例如代码风格统一、变量和方法等命名具体且有规律、代码结构具有规律。它很擅长挖掘已有代码潜在的规律，然后去模仿推导。以 VS Code 为例（JetBrains IDE 同理）。

·通过代码注释引导补全。

·通过已有平级同类型代码引导补全。

·通过潜在代码规律引导补全。