在cursor中编写可发布sql需明确目标环境、重写为发布态（with封装、显式字段、参数化）、添加元信息与验证注释，并导出为带环境标识的独立sql文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中编写SQL查询并生成可发布的版本，核心是让代码脱离开发环境依赖、适配生产数据库权限与结构、且能被团队复用或集成到CI/CD流程中。不能直接把调试时写的SELECT * FROM users;扔进Git仓库就当发布版。
确认查询目标与执行环境
先明确这个SQL要跑在哪——是PostgreSQL 15的只读从库？还是MySQL 8.0的业务主库？不同数据库语法差异大，比如LIMIT在PostgreSQL里要配合OFFSET才安全，而MySQL允许LIMIT 10,20但不推荐用。查不到目标环境版本，后面所有优化都可能白做。
打开Cursor右下角数据库连接状态栏，点击当前连接名→查看Connection Details→记下Database Type和Version字段值。
如果连接的是本地SQLite或内存数据库，【绝不能】把这类查询标记为“可发布”，它根本无法在生产环境运行。
重写SQL：从调试态到发布态
方法一：用WITH子句封装逻辑，避免嵌套子查询
把原来写在WHERE里的复杂条件拆出来，例如把(SELECT COUNT(*) FROM orders WHERE user_id = u.id) > 5这种关联子查询，改成WITH active_users AS (SELECT user_id FROM orders GROUP BY user_id HAVING COUNT(*) > 5) SELECT * FROM users u JOIN active_users au ON u.id = au.user_id；这样可读性高，也方便DBA加索引。
方法二：显式声明字段，禁用SELECT *
生产SQL必须列出全部字段名，比如SELECT id, name, email, created_at FROM users WHERE status = 'active'；否则表结构变更时会导致下游解析失败，尤其对接BI工具或ETL任务时，字段顺序错位会静默出错。
方法三：参数化硬编码值
把WHERE created_at > '2024-01-01'改成WHERE created_at > $1，并在Cursor的Query Variables面板里绑定对应日期参数；这样同一份SQL可在不同时间范围复用，也避免SQL注入风险——哪怕你确定这是内部脚本，发布版必须按安全规范来。
添加元信息与验证注释
第一步：在SQL开头插入三行注释
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
-- @purpose: 统计近30天活跃用户数（用于周报看板）
-- @author: your_name@company.com
-- @tested_on: PostgreSQL 15.4 / prod-read-replica-02
第二步：在结尾追加一行验证语句
-- VERIFY: SELECT COUNT(*) FROM (上面主查询) AS _t; 应返回 1274–1350 之间
这行VERIFY不是执行语句，是给运维或交接人看的手动校验提示。数值范围要基于最近三次运行结果取交集，不能拍脑袋写。
第三步：删掉所有-- debug: xxx之类的临时注释，发布版不允许存在调试痕迹。
导出为独立SQL文件
点击Cursor右上角「Export」→选择「SQL File (.sql)」→保存路径选项目根目录下的scripts/release/目录下。
文件命名必须含环境标识和日期，例如user_active_count_prod_20240521.sql；漏掉prod或日期，下次回溯时根本分不清哪个是上线版本。
导出后立刻用VS Code或命令行打开该文件，检查首尾是否有多余空行、BOM头、不可见Unicode字符——Cursor导出偶尔会在UTF-8文件开头插入零宽空格，导致某些调度器执行时报错“unexpected token”。
