写代码时，最令人头疼的环节之一，莫过于写完一段逻辑后还得回头补注释——格式是否规范、字段是否完整、是否需要添加异常说明……反复调整往往非常耗时。CodeGeeX 针对这一痛点提供了四种不同的注释生成路径，覆盖了从“写完即用”到“项目有严格规范必须遵循”的多种场景。下面逐一拆解这四种方式，帮你判断哪种更适合日常工作。

实际上，你真正期望的是：在写完一个函数、类或接口之后，能立即配上规范、准确且符合项目风格的注释，而不是反复修改、查阅文档、纠结标点格式。CodeGeeX 的四种方式，正是围绕这一目标设计的。

右键菜单一键加注释

这是最省心的方法，适用于已经写完代码、希望快速补全说明的场景。操作非常简单：用鼠标拖选目标代码块（可以是单行、一个方法或整个类声明），右键点击，在弹出菜单中选择「CodeGeeX Tool」，然后点击「Add Comment」。等待右下角 CodeGeeX 图标停止旋转，注释就会以灰色预览形式自动插入到代码上方或内部对应位置。最后一步不可忽略：按 Tab 键确认插入，或按 Esc 键取消，否则注释不会真正生效。

用 /** 回车触发 OpenAPI 注释

这一技巧专为 Spring Boot Controller 设计，能够生成包含 @Operation、@Parameter、@ApiResponse 的标准 JavaDoc。操作要点：将光标放到目标 REST 方法（比如 @GetMapping）正上方的空行，输入 /** 后立即按 Enter（回车），不要多打空格或换行。CodeGeeX 会自动补全完整的 JavaDoc 块，并带出包含业务语义的中文 summary 和 description。如果方法参数是已编译的 DTO，字段级描述也会自动展开——但需要注意：DTO 必须已经在当前模块 classpath 中成功编译，否则一律标记为 object。

用自然语言注释引导定制输出

当项目有较强约束规范时——比如 Swagger 注解、Google Python docstring、JSDoc 特定标签——纯模型推断容易遗漏字段，这时你需要“告诉它如何写”。具体有两种做法：一种是在函数上方空行手写指令，例如“// 生成 Swagger 兼容注释：描述为‘根据ID查询用户’，参数 id 为路径变量，返回 User 对象，404 时抛出 ResourceNotFoundException”。将光标停在这行末尾，按 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）激活交互模式。CodeGeeX 会解析其中的结构化指令，生成包含 @ApiParam、@ApiResponse 等完整注解的代码块。从候选结果中点击“Use Code”插入——注意，这一步不会覆盖已有的合法注释，但会替换以非法开头（比如 // 而不是 /**）的整块内容。

命令面板调用智能问答模式

这个模式适合在调试过程中临时补充注释，或者对某段逻辑不确定该强调什么时使用。首先确保 CodeGeeX 侧边栏已打开（视图 → 插件扩展视图 → CodeGeeX），然后在 Ask CodeGeeX 输入框中输入 /comment 并回车。如果光标在函数内部，系统会自动生成参数说明、返回值描述及异常标注；如果光标在空行，则需要手动补充上下文，例如“为下方 Java 方法添加 JavaDoc 格式注释，强调线程安全性”。从右侧候选列表中点击“Use Code”按钮完成插入。