Fitten Code注释生成完整逻辑代码设置方法

使用 Fitten Code 生成代码的核心流程分为三步：首先确保 AI 代码生成功能已开启，然后编写包含英文 Args/Returns 的结构化注释，最后通过快捷键、右键菜单或命令面板触发生成。生成后还需验证函数签名、逻辑正确性，并运行测试确认结果。

该方法本质上是利用自然语言注释自动生成完整逻辑代码。前提是 Fitten Code 的 AI 编程辅助功能已开启，且注释中明确标注输入输出，结构清晰。

启用 Fitten Code 的 AI 代码生成功能

打开 VS Code → 点击左侧活动栏的 Fitten Code 图标 → 右上角齿轮进入设置 → 找到「AI Assistant」选项卡 → 将「Enable AI Code Generation」开关拨至开启状态。

此步骤不可省略，否则注释再完整也不会触发代码生成。关闭状态下，注释内容再多，右键菜单也不会出现「Generate Code from Comment」选项。

编写可被识别的结构化注释

在编辑器中新建一个 .py 文件，将光标放在函数定义位置上方，输入三重双引号开始编写文档注释。

注释第一行说明函数功能，第二行起用「Args:」列出参数名、类型和含义，下一行用「Returns:」说明返回值类型与意义。例如："""计算用户订单总金额，支持折扣叠加。nArgs:n items (list[dict]): 商品列表，每个字典含 'price' 和 'qty' 键n discount_rate (float): 折扣率，范围 0.0～1.0nReturns:n float: 折后总金额，保留两位小数n"""

注意，Fitten Code 不解析中文句式或模糊描述。Args 和 Returns 必须使用英文冒号加换行缩进格式，且参数名需与后续实际使用的变量名一致。若写成「参数：商品列表」或「返回：钱数」，生成将失败。

触发注释转代码的三种方式

方法一：快捷键触发
确保光标位于注释块内部或紧贴其下方 → 按 Ctrl+Shift+I（Windows/Linux）或 Cmd+Shift+I（Mac）→ 等待右下角出现「Generating...」提示 → 生成完成后自动插入函数骨架。

方法二：右键菜单触发
选中整个注释块（包括三重引号）→ 右键 → 选择「Fitten: Generate Function from Comment」→ 生成结果以代码块形式显示在编辑器中间，点击「Insert」即可粘贴到光标位置。

方法三：命令面板触发
按 Ctrl+Shift+P（或 Cmd+Shift+P）→ 输入「Fitten: Generate」→ 选择「Fitten: Generate Code from Current Comment」→ 适用于注释跨多行或未完全选中的情况，比手动选区更稳定。

验证生成逻辑是否符合预期

第一步：检查生成的函数签名是否与注释中的 Args/Returns 完全匹配，包括参数顺序、名称、类型提示（若未启用 type hint 插件，Fitten Code 默认不加）。

第二步：查看函数体是否包含基础校验逻辑，例如对 items 是否为 list、discount_rate 是否在 0～1 区间内进行 assert 或 if 判断。若未生成，说明注释中缺少「需校验输入有效性」等明确指令。

第三步：在函数末尾添加一行 # test: print(calculate_total([{'price': 100, 'qty': 2}], 0.1)) → 保存文件 → 点击右上角「 Run」按钮执行 → 查看终端输出是否为 180.0。