在本地VSCode中用CodeGeeX生成SQL需安装插件、切换本地模式并下载4.2GB模型；手动提供表结构注释或JSON Schema；输入明确中文需求后按Ctrl/Cmd+Enter触发补全，输出以PostgreSQL语法为基准，需按目标数据库调整。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在本地 VSCode 中用 CodeGeeX 自动生成 SQL 语句，需要先安装插件并完成模型加载，再配合数据库上下文触发补全——没有联网调用远程 API，所有推理都在本机运行，因此必须确保显存或内存足够加载 2B 参数量的 CodeGeeX 模型。
安装 CodeGeeX 插件并启用本地模式
打开 VSCode → 左侧扩展商店 → 搜索 “CodeGeeX” → 点击安装 → 安装完成后点击“重新加载”按钮重启窗口。
首次启动插件时，默认走云端服务；必须手动切换至本地运行：点击右下角状态栏的 “CodeGeeX” 图标 → 选择 “Switch to Local Mode” → 弹窗提示下载模型文件（约 4.2GB），【下载路径不可更改，必须保留在默认缓存目录，否则插件无法定位模型】。
等待下载完成并自动解压，状态栏图标变为绿色即表示本地模型加载就绪。
配置数据库表结构上下文
CodeGeeX 本地版不会自动读取数据库元信息，必须人工提供表结构描述才能生成准确 SQL。
方法一：在当前编辑的 .sql 文件顶部，用注释块写明表名、字段名及类型，例如：
-- TABLE users (id INT PK, name VARCHAR(50), email VARCHAR(100), created_at DATETIME)
方法二：在光标所在行上方插入三引号包裹的 JSON Schema（推荐用于复杂关联场景）：
```json
{"tables": [{"name": "orders", "columns": [{"name": "order_id", "type": "BIGINT"}, {"name": "user_id", "type": "INT"}, {"name": "status", "type": "ENUM('pending','paid','shipped')"}]}]}
```
注意：JSON 必须严格合法，字段名不能带空格或特殊符号，否则模型解析失败后将返回空建议。
编写自然语言需求并触发补全
第一步：在已含表结构注释的 .sql 文件中，新起一行输入中文需求，例如：查询上个月注册且邮箱未验证的用户数量。
第二步：将光标置于该行末尾 → 按 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）触发补全 → 插件会在下方插入生成的 SQL 块。
第三步：生成结果默认带 -- generated 注释头，可直接执行或手动调整；若结果含语法错误（如 MySQL 中用了 PostgreSQL 的 LIMIT OFFSET 写法），需根据目标数据库方言手动修正——【CodeGeeX 本地模型不绑定具体数据库引擎，输出语法以 PostgreSQL 为基准】。
这一步操作起来很简单，直接把需求写清楚就行，但别写“查一下数据”，要明确时间范围、过滤条件和聚合方式。
