必须安装 microsoft 官方 mssql 扩展，macos/linux 需额外安装 msodbcsql17 和 mssql-tools 驱动；连接需填写严格格式的完整连接字符串（如 server=127.0.0.1,1433;database=master;user id=sa;password=xxx），并手动激活连接，否则查询报“no active connection found”。
VSCode 本身不连 SQL Server，装了插件也不自动连——必须装对扩展、配好驱动、填准连接字符串，三者缺一不可。
必须装 Microsoft 官方的 mssql 扩展，别被名字骗了
VS Code 扩展市场里叫“SQL Server”的插件有好几个，但只有 mssql（作者 Microsoft）能真正连接、执行、提供 T-SQL 补全。其他如 SQL Server Compact、SQL Server Tools 等，要么只做高亮，要么压根不支持连接。
- Windows 用户装完基本可用；macOS/Linux 必须额外装驱动：
msodbcsql17和mssql-tools，否则点连接就报ODBC Driver 17 for SQL Server not found - 装完后务必重启 VSCode，否则
Ctrl+Shift+P里搜不到MSSQL:Connect - 右下角状态栏显示
Plain Text？点它手动切到SQL模式，否则补全和语法诊断全失效
Connection String 格式错一个字符就连接失败
新建连接时填的不是“服务器名”，而是完整连接字符串，格式不能靠猜：
- 最简可用形式：
Server=localhost,1433;Database=master;User Id=sa;Password=your_password; -
localhost在 Docker 或远程场景下常不通，换成127.0.0.1或具体 IP 更稳 - 端口必须显式写，比如
Server=192.168.1.100,15000；默认 1433 被占或改过就直接超时 - 密码含
@、/等特殊字符？必须 URL 编码，例如Password=pass%40123 - SQL Server Authentication 要启用
sa账户且密码非空；Windows 身份验证在mssql插件里不支持
执行 SQL 前先确认连接已激活，别让查询跑进黑洞
点击侧边栏 mssql 图标 → “+ New Connection” 只是创建配置，不等于连上了。常见误操作：
- 没右键连接项选
Connect，状态栏没出现数据库图标，就直接按Ctrl+Shift+E—— 报错是No active connection found，不是超时 - 一个
.sql文件可同时关联多个连接，右上角有下拉菜单切换目标；选错连接会查到别的库甚至报Invalid object name - 执行大表
SELECT *卡住？默认查询超时 30 秒，去设置里搜mssql.queryTimeout改成300（单位秒），或在连接串末尾加;Connection Timeout=300 -
mssql不支持连接池，每次执行都新建连接；频繁查大数据建议加TOP 1000限制返回行数
中文乱码、结果不显示、补全不弹出——先看 language server 是否启动
有高亮但输 SELECT 不提示字段，或执行后结果面板空白，大概率是后台 language server 没起来：
- 打开开发者工具：
Ctrl+Shift+P→Developer: Toggle Developer Tools→ Console 标签，刷一下看有没有mssql相关报错，比如spawn ENOENT（驱动路径不对）、connection refused（服务没开） - 确保
mssql.enableIntelliSense设置为true，这个开关默认是false - 中文字段/值显示为问号？检查 SQL Server 的
collation是否为Chinese_PRC_CI_AS或兼容 UTF-8 的排序规则；VSCode 文件编码设为UTF-8（右下角点击编码名切换） - 补全依赖数据库元数据加载，首次连接后可能需等几秒，期间输
FROM不出表名属正常，稍等再试
最容易被忽略的是：连接字符串里漏掉 Database=xxx，导致连上 master 却查自己库的表；或者以为装了插件就万事大吉，其实驱动、认证、超时、编码四层全得对得上才动得了真格。
