能连上SQL Server的前提是实例运行、端口开放且凭据正确;需安装Microsoft官方mssql扩展,通过命令面板执行MS SQL: Connect配置连接参数,并确保.sql文件绑定连接后方可执行查询。

能连上,前提是 SQL Server 实例正在运行、端口(默认 1433)没被防火墙拦住,且你有登录凭据。
安装 mssql 扩展是第一步,但不是装完就自动可用
VSCode 本身不带数据库连接能力,必须靠 mssql 扩展。它由 Microsoft 官方维护,支持 SQL Server、Azure SQL、SQL Managed Instance 和 Azure Synapse。
- 打开 VSCode,按
Ctrl+Shift+X进扩展市场,搜SQL Server (mssql),认准发布者是Microsoft - 点击安装,**不用重启 VSCode** —— 扩展会自动拉取
SQL Tools Service后端进程 - 装完后侧边栏会出现
SQL Server图标,但此时还不能连,因为没配置任何连接
用 MS SQL: Connect 命令填参数,别信“自动检测”
很多人卡在第一步:点了连接图标却没反应。正确入口是命令面板,不是侧边栏图标。
- 按
Ctrl+Shift+P打开命令面板,输入MS SQL: Connect并回车 - 选择“
Connection Profile”,然后逐项填:-
Server:本地实例填localhost或127.0.0.1;命名实例要写全,比如localhost\SQLEXPRESS -
Authentication type:选SQL Login(除非你在 Windows 域环境且用集成认证) -
User name和Password:比如sa用户,或你创建的其他登录名 -
Database:可留空,连上后再选;填了则直接切换到该库 -
Profile Name:起个有意义的名字,比如local-dev-sql2022,方便后续管理
-
- 填完按回车,如果弹出“Connected to …”提示,说明成功;否则检查错误信息,常见的是
Failed to connect to server或Login failed for user
连不上?先确认这三件事再调参数
90% 的连接失败不是配置错,而是底层服务或网络没就绪。
-
sqlservr.exe进程是否在运行?打开 Windows 服务管理器,确认SQL Server (MSSQLSERVER)或对应实例名的服务状态是“正在运行” - SQL Server 是否启用了 TCP/IP 协议?用
SQL Server Configuration Manager检查“SQL Server 网络配置 → 协议 → TCP/IP”是否已启用 - Windows 防火墙是否放行了 1433 端口?临时关闭防火墙测试一次,能连就说明是它挡的
- 如果是命名实例(如
SQLEXPRESS),确保SQL Server Browser服务也已启动,否则客户端无法解析实例名
保存连接后,.sql 文件里才能执行查询
连接成功只是建立会话,真正执行语句还得靠文件上下文绑定。
- 新建一个
.sql文件(比如test.sql) - 保存前,看 VSCode 窗口右下角状态栏 —— 它应该显示你刚起的
Profile Name,比如local-dev-sql2022;如果显示No active connection,说明当前文件没绑定连接 - 点击状态栏那个名字,可切换或重新选择连接
- 写一句
SELECT GETDATE(),选中后按F5或右键选Execute Query,结果会出现在下方Results面板 - 如果报错
Invalid object name,大概率是没指定Database,或者当前连接指向了master库而你查的是别的库的表
最常被忽略的点:VSCode 不会记住你上次用的连接,每个新 .sql 文件都要手动绑定一次;而且连接配置只存在用户设置里,换电脑或重装 VSCode 就得重配 —— 别指望它自动同步。


















