通过 Fitten Code 实现 AI 代码生成，核心流程仅需三个步骤：首先确保 AI 代码生成功能已启用，其次编写包含英文 Args/Returns 的结构化注释，最后通过快捷键、右键菜单或命令面板触发生成。生成完成后，务必验证函数签名、业务逻辑是否正确，并运行测试来确认结果。

简而言之，Fitten Code 利用自然语言注释自动生成完整的逻辑代码。前提是必须开启 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。