腾讯云代码助手自上线以来,已为超数万名开发者提供智能编程服务。在过去的一年里,通过开发者的反馈和自身实践,我们总结了一些使用腾讯云代码助手提升生产力的小技巧。与学习新框架或库类似,掌握如何高效利用 AI 工具也可以显著提高我们的工作效率。在《产品使用小技巧》系列中,我们将持续更新,分享日常使用腾讯云代码助手的技巧和实践,希望这些建议能够帮助开发者更高效地使用腾讯云代码助手 ,充分利用 AI 提升日常研发的效率和体验。
代码补全篇
大模型根据用户提供的 Prompt 输出结果,这意味着,我们提供的 Prompt 越丰富、准确,大模型的输出就越好,因此,尽可能提供详细的 Prompt 是关键,和使用 ChatGPT 时需要把所有背景信息显式地输入给大模型不同,腾讯云代码助手可以从您的 IDE 中自动推断需要用到的上下文,并将其作为 Prompt 输入给大模型。接下来我们将分享一些基本技巧,以便您在使用腾讯云代码助手时能提供更加详细的上下文。
技巧一:打开或导入相关代码文件
在发送给大模型的 Prompt 中,除了当前代码文件的上下文以外,腾讯云代码助手还会将 IDE 的其他信息也加入到 Prompt 中,其中比较重要的有两个:
IDE 所有打开文件中与当前代码相似的代码片段。
导入包中的相关代码。
因此,确保所有相关文件都是打开状态,并且 import 所有需要用到的代码文件,这样腾讯云代码助手就可以获取更多的上下文信息,从而推荐地更加准确。
技巧二:提供顶层注释
就像在汇报时通常需要先提供一个简短的概述一样,我们在文件顶部添加顶层的注释,描述文件的主要功能和预期目标。这有助于腾讯云代码助手理解整体上下文,提供更相关的代码建议。请在注释中包含您需要的详细内容并提供规范的描述,以便腾讯云代码助手能接收到更多信息并提供更好的建议。


技巧三:提供有意义的变量和函数名
1. 使用有意义的变量和函数名有助于腾讯云代码助手更好地理解您的代码意图。
如果您有一个名为“foo”或者“calculate”的函数,腾讯云代码助手可能无法提供最佳的代码补全效果,因为它无法从命名中推断出您的意图。因此,在使用 AI 工具的过程中,要遵守良好的命名规范,例如:getUserData,清晰明了,大大提升了代码阅读性。良好的命名规范,可以提升代码阅读性,降低维护成本,同时也能让代码助手更容易理解,增强代码补全效果。


2. 在代码补全场景中,注释是一个向模型提出明确需求的好方法。
函数名的描述能力有限,过长的函数名会影响代码的简洁性,因此函数注释可以帮助填补细节。在函数前添加准确的注释,描述函数的功能和参数,使得腾讯云代码助手能够更好地理解函数的目的和实现细节,从而提供更具体的建议。请注意,明确、简洁的注释更有利于腾讯云代码助手生成符合您预期的内容。


技术对话篇
腾讯云代码助手技术对话提供了类似 ChatGPT 的体验,支持多轮对话以及发起不同的对话,使您不用离开 IDE 环境就能得到对话式 AI 的帮助。另外,腾讯云代码助手技术对话可以利用编辑器中的代码文件提升回答效果,我们也提供了一系列内置指令帮助用户更便捷地引用编辑器中的上下文以及完成常见任务。
技巧一:使用指令提升沟通效率
腾讯云代码助手技术对话目前提供了3种类型的指令:
智能体(@):具有额外的知识、上下文与能力。
斜杠命令(/):常见提示词的快捷方式,例如我们提供了一些简单命令帮助您快速完成解释代码、修复代码等工作。
引用(#):通过 # 指令,可以选择添加当前项目文件、知识库或者指定文件作为上下文,增强模型输出的质量。

在技术对话中,可以直接选择指令进行快速对话。

技巧二:指定需要使用的包或模块
当您需要使用特定版本的包时,最好在对话中主动指定,这有助于腾讯云代码助手技术对话在给出建议时使用您希望使用的包,因为有时候腾讯云代码助手技术对话会使用较低版本的包给出建议。

技巧三:使用上下箭头浏览历史提问
就像在终端中可以利用上下箭头浏览之前输入的命令一样,在腾讯云代码助手技术对话的输入框中,您也可以通过上下箭头浏览您之前的问题。
技巧四:选中相关代码,向 AI 提问建议
1. 选中片段,选择页面中对应功能向 AI 提问。

2. 或者右键选择对应功能向 AI 提问,得到解决方案。

技巧五:分不同会话询问关于不同主题的问题
通过新增对话或者采用对话中快捷指令 /clear 重新开启新对话,避免历史对话上下文带来的影响。
