必须启用表格视图并确认插件支持：database client和sqltools v4+默认支持，需在设置中勾选databaseclient.resultsastable或sqltools.resultsastable；老版mysql插件（v3.x前）不支持表格，须升级至v4.0+。
VSCode 里执行 SQL 后只看到文本，不是表格？
这不是插件没装好，而是表格视图被关了或插件不支持。Database Client 和 SQLTools v4+ 默认支持表格结果，但必须手动启用。打开 VSCode 设置（Ctrl+, 或 Cmd+,），搜索 databaseclient.resultsAsTable 或 sqltools.resultsAsTable，确保勾选。如果用的是老版 MySQL 插件（v3.x 及之前），它压根不渲染表格——得卸载重装 cweijan.vscode-mysql v4.0+。
SELECT * 返回 10 万行，VSCode 卡死或无响应？
插件默认不限制返回行数，但 UI 渲染大量数据会拖垮整个窗口。别等它自己恢复，先在设置里搜 databaseclient.maxRows 或 sqltools.maxRows，设成 5000 以内。更稳妥的做法是：写查询时主动加 LIMIT，比如 SELECT * FROM logs ORDER BY id DESC LIMIT 1000;。注意，LIMIT 必须写在语句末尾，且不能和分号之间有空行——有些插件（如 SQLTools）会把空行当作语句分隔符，导致只执行前半段。
右键 Execute Query 没反应，或提示 No active connection？
这说明当前 .sql 文件没绑定到任何连接。检查三处：
• 右下角状态栏有没有显示连接名（如 pg-local 或 mysql-prod），没有就点它手动选；
• 如果用的是 SQLTools，确认文件顶部写了连接注释，例如 -- @conn mysql-prod；
• Database Client 不依赖注释，但要求你在侧边栏 Database 视图里右键某个连接 → Set as Default Connection，否则它不知道该发给谁。
MySQL 连不上，报 authentication failed 或 connection refused？
90% 是认证插件或网络栈不匹配：
• MySQL 8.0+ 默认用 caching_sha2_password，而多数插件只认 mysql_native_password —— 在连接参数里加 "authPlugin": "mysql_native_password"；
• localhost 在某些配置下走 Unix socket，插件只走 TCP —— 改成 127.0.0.1；
• 密码含 @、/、: 等字符？URL 编码后填，比如 pa@ss/word → pa%40ss%2Fword。
真正容易被忽略的不是“怎么连”，而是“连上之后哪些 SQL 写法会静默失效”：变量赋值（SET @x = 1）、事务块（BEGIN; UPDATE; COMMIT;）、临时表创建——这些依赖会话上下文的功能，在 Database Client 和 SQLTools 中默认每个查询独占会话，不会延续。想用就得合并成单条语句，或改用终端直连。
