优先选mssql插件连sql server，因其自带t-sql语言服务器、执行计划可视化等功能；需同时连多种数据库则必须用sqltools配合对应驱动。

能运行 SQL 脚本，但必须装对插件、配对驱动、设对语言模式——缺一不可，否则 Ctrl+Enter 只是敲了个寂寞。

装哪个插件：SQLTools 还是 mssql？

取决于你连什么数据库：

• 只连 SQL Server，且用 Windows 身份验证或固定实例名：装 mssql（扩展 ID microsoft.mssql）最稳，自带连接向导和执行计划可视化
• 要同时连 MySQL、PostgreSQL、SQLite 中的多个，或需要多环境切换：必须装 SQLTools（作者 mtxr），再单独装对应驱动，比如 SQLTools MySQL/MariaDB Driver
• 别装名字含 Syntax、Highlight、Formatter 的插件——它们不提供执行能力，右下角点成 SQL 也没用

连接失败常见报错和硬性检查点

报 Failed to connect 或 Login failed for user 不是密码错了那么简单：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• SQL Server 用户：确认 SQL Server 配置管理器里 TCP/IP 已启用，IPAll → TCP Port 明确填了 1433（不是留空），防火墙放行该端口
• MySQL 用户：如果用 Docker/WSL2/M1，host 别填 localhost——WSL2 填 /etc/resolv.conf 里的 nameserver IP，M1 Rosetta 下改用 127.0.0.1
• 密码含 @、/ 等字符：必须 URL 编码，比如 my@pwd → my%40pwd
• 所有插件都要求显式填 database 字段：留空会报 No database selected 或 Table 'xxx' doesn't exist，不是连接失败，是根本没选库

执行前必须手动设语言模式

新建 .sql 文件默认是 Plain Text，语法高亮、补全、执行按钮全失效：

• 点击 VSCode 右下角状态栏显示的 Plain Text，从弹出菜单选 SQL（不是 T-SQL，那是旧别名）
• mssql 插件默认不启动智能提示，需在设置里开 "mssql.enableIntelliSense": true
• SQLTools 的补全依赖已配置连接——哪怕只连一个本地 SQLite 文件，否则 SELECT * FROM 后不会列表名
• 快捷键别混：Ctrl+Shift+E 是 mssql 的执行键，Ctrl+Enter 是 SQLTools 的默认键（可在设置里改），按错就毫无反应

结果输出和容易被忽略的边界

执行后结果以表格形式出现在面板，但几个关键限制常被跳过：

• mssql 支持查看图形化执行计划，SQLTools 只输出文本格式的 EXPLAIN 结果，没法点开节点分析
• 多语句用分号隔开，但 SQLTools 默认只执行光标所在“语句块”（上一个分号到下一个分号之间），不是全文
• SQLite 插件（如 alexcvzz 版）只识别当前工作区目录下的 .db 或 .sqlite 文件，双击打开单个文件无效
• Python 脚本改了 SQLite 数据，VSCode 插件不会自动刷新——得手动右键表名 → “Refresh Table”