能直接将自然语言转为可执行SQL需插件+上下文+明确提示三者到位；缺一不可，否则易漏关键子句或生成错误语句。
能直接把“查上个月销售额最高的5个产品”这种话变成可执行SQL的，不是靠猜表名、也不是翻文档，而是靠插件+上下文+明确提示三者到位。其他路径要么慢，要么错。
CodeGeeX 插件生成 SQL 必须登录且带完整要素
未登录状态下 Ctrl+Shift+I 唤出的对话框不会返回任何 SQL；即使登录了，如果提问里缺时间范围、聚合条件、排序要求中的任一要素，生成的语句大概率漏 HAVING 或 ORDER BY。
- 正确示例：“列出2024年7月订单金额超5000的客户ID、姓名和总金额，按总金额降序排前10”
- 错误示例：“查大额客户”——模型无法推断时间、阈值、字段来源
- 若结果中出现
= '2024-07'而非BETWEEN '2024-07-01' AND '2024-07-31'，说明提示没强调日期精度，需追加“请用闭区间日期范围”
SQLTools 补全失效 ≠ 插件没装好，而是连接没活过来
右下角状态栏显示 Plain Text 时，SELECT * FROM 后按 Ctrl+Space 绝对没反应——必须点它手动切到 SQL 模式，VSCode 才会加载语言服务。
- 侧边栏 SQLTools 面板里，连接名右侧必须是绿色
▶️，灰色或❌表示未连通 - SQLite 用户注意：
${workspaceFolder}/data.db这个路径下的文件必须真实存在，SQLTools 不会自动创建 - PostgreSQL/MySQL 用户：光装 SQLTools 不够，还得单独装对应驱动插件（如
SQLTools PostgreSQL Driver） - 字段补全只在
table_name.后触发，写WHERE users.容易被解析器忽略，优先用SELECT users.测试
敏感数据或复杂语法必须本地跑 SQLCoder
涉及窗口函数、CTE 嵌套、EXISTS 子查询，或者数据不能出内网时，SQLCoder 是目前唯一支持 8-bit 量化本地部署的成熟方案。
- 准备 schema 文件：导出建表语句为
your_schema.sql，确保含COMMENT字段说明（模型依赖注释理解业务含义） - JSON 字段要特别提醒：“该字段为 JSON 类型，请勿在 WHERE 中直接等值比较”，否则生成的
WHERE meta = 'xxx'会报错 - 启动后首次生成较慢（需加载模型），后续响应基本在 2 秒内；但不支持跨库 JOIN 的自动别名推导，得手动在提示里写明 “users 表来自 public schema，orders 表来自 sales schema”
真正卡住人的从来不是语法本身，而是表别名绑定错、时间字段类型误判、JSON 字段当普通字符串用——这些细节不会报红，但一执行就空结果或报错。补全和生成只是加速器，上下文喂得准不准，决定它到底帮你省时间，还是埋雷。
