VSCode中SQL文件悬停无法显示表结构,是因为默认SQL语言模式不支持符号解析;需安装mssql、vscode-sqlite或SQLTools等扩展,将语言模式设为对应专用模式(如SQL (MSSQL)),且表定义须为顶层独立CREATE TABLE语句,同时确保editor.hover.enabled开启及扩展hover provider正常运行。

SQL 文件里悬停看不到表结构,是因为没启用符号解析
VSCode 默认的 SQL 语言模式(Plain Text 或基础 SQL)不解析 CREATE TABLE 语句,所以悬停时不会显示字段列表或类型。这不是 bug,是设计如此——它只做语法高亮,不建符号索引。
要让悬停生效,必须满足两个前提:
- 安装支持符号提取的扩展,比如
mssql(T-SQL)、vscode-sqlite(SQLite)或SQLTools配合对应驱动 - 文件语言模式必须设为对应扩展注册的模式,例如右下角状态栏点击后选
SQL (MSSQL),而不是SQL或Plain Text - 表定义得是顶层、未被注释包裹、未嵌套在
IF NOT EXISTS或存储过程体内的独立CREATE TABLE语句;否则多数扩展会跳过解析
不同数据库对应的悬停能力差异很大
不是所有扩展都支持悬停预览表结构,支持程度取决于底层驱动和语言服务器实现:
-
mssql扩展:仅当连接到真实 SQL Server 实例后,对已知数据库中的表名悬停才显示列名+类型(依赖系统视图查询),纯.sql文件里不生效 -
vscode-sqlite:打开.sqlite文件后,悬停表名可直接弹出字段定义(含NOT NULL、默认值),但仅限当前 DB 文件内存在的表 -
SQLTools+ PostgreSQL/MySQL 驱动:需先建立连接并设为 Default Connection,之后在.sql文件中悬停已知表名,才可能触发远程元数据查询并展示字段 - SQLite Viewer:只在打开
.db或.sqlite3文件时生效,悬停表名显示完整 DDL 和索引信息,不适用于普通.sql脚本
悬停失效时先检查这三处配置
常见“悬停无反应”问题,90% 出在这几个地方:
- 右下角语言模式显示的是
SQL,不是SQL (MSSQL)/SQL (SQLite)等带括号的专用模式 —— 这说明扩展未接管该文件 - VSCode 设置中
editor.hover.enabled被关了(搜这个设置项确认是否勾选) - 扩展的 hover provider 没启动:按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools,看 Console 是否报错如Cannot find language server for sql - 对于
SQLTools,还需确认设置了sqltools.showHover为true(默认开启,但有人会手动关掉)
想稳定看到结构,别只靠悬停
悬停是辅助手段,不是主干功能。真正可靠的方式是:
- 用侧边栏数据库树(Database Client / SQLTools)展开表 → 右键
Show Create Table查完整 DDL - 在
.sql文件中写好SELECT * FROM users LIMIT 1→ 执行后结果表格上方会显示各字段类型(Database Client 默认开启) - 对 SQLite,直接双击打开
.db文件,左侧树形结构点开表,右侧就是字段详情面板
悬停提示依赖实时解析或远程查询,网络延迟、大库元数据量、扩展未激活都会导致空白——把它当成快捷预览,别当成唯一入口。











