fitten code支持通过注释自动生成sql语句。需先在设置中启用【sql generation from comments】并重启编辑器；注释须为// @sql或/* @sql格式，位于.js/.ts等支持文件的顶层作用域；支持单表查询、多表关联及{{ }}参数占位，但不校验字段名且不支持反引号与with recursive等复杂语法。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Fitten Code中，只需在代码注释里用特定语法描述数据操作意图，就能自动生成可执行的SQL语句，省去手动拼写WHERE条件、字段名大小写错误、引号遗漏等常见问题。
启用注释转SQL功能
打开Fitten Code设置 → 编辑器 → 勾选【SQL Generation from Comments】选项 → 重启编辑器使插件生效。
这一步必须完成，否则所有后续注释都不会触发SQL生成。未勾选时即使写下完整注释，右键菜单里也看不到“Generate SQL”选项。
基础语法：单表查询生成
在JavaScript或TypeScript文件中，任意位置写如下格式注释：
// @sql SELECT * FROM users WHERE status = 'active' AND created_at > '2024-01-01'
光标停留在该行 → 右键 → 点击“Generate SQL” → 自动生成带分号结尾的标准SQL语句并插入到光标下方。
注意：@sql后面必须紧跟空格，且整行不能有其他字符；字段名和表名不校验是否存在，【生成结果完全依赖你写的注释内容，不会做语法纠错】。
进阶写法：多表关联与参数占位
方法一：使用{{ }}包裹动态参数
// @sql SELECT u.name, o.total FROM users u JOIN orders o ON u.id = o.user_id WHERE u.role = '{{role}}' AND o.status != '{{exclude}}'
执行生成后，Fitten Code会弹出输入框，依次让你填入role和exclude的值，最终输出带实际字符串的SQL（自动加单引号）。
方法二：用/**/块注释支持多行结构
/*
@sql INSERT INTO products (name, price, category)
VALUES ('{{name}}', {{price}}, '{{category}}')
*/
这种写法适合复杂语句，但必须保证@sql出现在块注释第一行，否则无法识别。
安全限制与不可用场景
第一步：确认当前文件后缀为.js、.ts、.jsx或.tsx，.py/.java等其他语言文件不支持该功能。
第二步：检查注释是否位于函数体外或顶层作用域——若写在函数内部且被缩进超过4空格，Fitten Code会跳过解析。
第三步：避免在注释中使用反引号、嵌套SQL关键字如`WITH RECURSIVE`，这类语法目前不被解析器支持，会直接报错“Invalid SQL template”。
