新建.sql文件只是创建文本容器，关键需完成三步：安装对应数据库扩展、配置有效连接、确保文件被识别为sql上下文；漏任一环则快捷键执行失败。
新建 .sql 文件只是第一步，关键在后续三步
VSCode 本身不识别 .sql 文件为可执行脚本，新建一个 .sql 文件（比如右键 → New File → 命名为 query.sql）只是创建了文本容器。真正让它“活起来”，必须完成：安装对应扩展、配置有效连接、确保文件被正确识别为 SQL 上下文。漏掉任一环，按快捷键就静默失败或报 No active connection found。
选对扩展：SQLTools vs mssql vs PostgreSQL 扩展不能混用
不同数据库协议要配不同扩展，不是装一个“SQL 插件”就万事大吉：
- MySQL / PostgreSQL / SQLite 等通用场景 → 装
SQLTools+ 对应驱动（如SQLTools MySQL/MariaDB Driver） - SQL Server（本地、Azure SQL、Fabric）→ 装
SQL Server (mssql)扩展（微软官方） - 纯 PostgreSQL 工作流且用 Microsoft 官方工具 → 可选
PostgreSQL扩展（ms-ossdata.vscode-pgsql），它自带连接 UI 和对象浏览器
注意：mssql 扩展对文件名和内容更敏感——它默认只在 .sql 文件中启用 T-SQL 语法支持，但若文件开头有 BOM 或编码不是 UTF-8，IntelliSense 可能失效；而 SQLTools 更依赖连接状态而非文件后缀。
新建查询编辑器 ≠ 新建文件，连接后才能真执行
光建个空 query.sql 还不够。推荐做法是：先建立连接，再从连接上下文新建查询编辑器：
- SQLTools：连接成功后，右键已保存的连接名 →
New Query，此时新标签页自动绑定该连接，光标落进去就能直接按Ctrl+Alt+R - mssql：连接后，在
Object Explorer中右键数据库 →New Query，生成的编辑器顶部会显示连接信息（如server/database） - PostgreSQL 扩展：点击活动栏
PostgreSQL图标 → 在连接树中右键服务器或数据库 →New Query
这样新建的编辑器自带上下文，不会出现“查得到表但执行报 invalid catalog name”这类路径错位问题。
为什么新建的 .sql 文件里写完 SELECT 按 Ctrl+Alt+R 没反应？
常见原因不是语法错，而是 VSCode 根本没把它当 SQL 文件处理：
- 文件未显式设置语言模式：右下角状态栏语言显示为
Plain Text，需点击它 → 选择SQL（或MySQL/PostgreSQL） - 扩展未激活该文件：
mssql扩展要求文件必须保存（哪怕空内容）、且路径不含中文或特殊字符；SQLTools则更宽松，但若文件未关联任何连接，快捷键也无效 - 光标位置不对：必须落在完整语句内（如
SELECT * FROM users;的任意位置），停在注释、空行或字符串中间都会触发Query is empty
最稳的验证方式：连接成功后，状态栏右下角出现数据库图标和连接名，这才是“准备好执行”的唯一信号——别信文件是否新建、是否保存、是否写了内容。
