应直接在VS Code扩展市场搜索并安装官方“SQL Server (mssql)”扩展，认准Microsoft发布者及蓝色数据库图标，安装后必须点击“Reload”而非仅重启，且需将文件语言模式设为SQL才能启用sqlcon等命令。
直接安装 SQL Server (mssql) 扩展的正确路径
VS Code 安装 SQL Server 扩展不需要额外下载文件或手动配置依赖，SQL Server (mssql) 是官方维护的扩展，所有依赖（包括 SQL Tools Service）会在安装后自动拉取并启动。
关键点是：别搜“vscode-mssql”或“mssql extension”这种模糊词，必须精确匹配扩展市场里的官方名称。
- 打开 VS Code，按
Ctrl+Shift+X（Windows/Linux）或Cmd+Shift+X（macOS）进入扩展视图 - 在搜索框中输入
SQL Server (mssql)—— 注意括号和空格都要一致，这是 Microsoft 官方发布的唯一主扩展 - 认准发布者为
Microsoft，图标是蓝色数据库加闪电标识 - 点击“Install”，完成后会提示“Reload Required”，务必点击“Reload”按钮（不是关闭再开，也不是忽略）
安装后没看到 SQL Server 侧边栏？常见原因
扩展装完但左侧没有 SQL Server 图标，大概率是没 reload 或语言模式没切对，不是安装失败。
- 检查是否真的点了“Reload” —— 仅重启 VS Code 不等于 reload 扩展上下文
- 新建一个文件（
Ctrl+N），在右下角状态栏点击“Plain Text”，选择SQL语言模式；否则MS SQL: Connect命令可能被禁用 - 如果仍不显示，打开命令面板（
Ctrl+Shift+P），输入sql，看是否能列出MS SQL: Connect、MS SQL: Execute Query等命令；能列出就说明扩展已激活
为什么 sqlcon 命令不响应？
sqlcon 是 MS SQL: Connect 的快捷命令别名，但它只在当前编辑器语言模式为 SQL 时才可用。这不是 bug，是设计行为。
- 确保当前 tab 是
.sql文件，或已手动设为 SQL 语言模式（状态栏右下角显示SQL） - 如果刚新建空白文件，VS Code 默认是
Plain Text，sqlcon会被忽略，此时先切换语言模式再试 - 若仍无效，执行
Developer: Toggle Developer Tools查看 Console 是否报错，常见错误如Failed to start SQL Tools Service，通常重启 VS Code 即可恢复
Docker Desktop 不装也能用，但本地容器功能会不可用
单纯连接已有 SQL Server 实例（比如本地 localhost 或远程 Azure SQL）完全不需要 Docker。只有启用 MS SQL: Create Container 这类命令时，才强制依赖 Docker Desktop 正在运行。
- 如果你只是想连公司内网 SQL Server 或 Azure SQL 数据库，跳过 Docker 安装步骤完全没问题
- 若后续尝试
MS SQL: Create Container报错Docker is not running，再去官网下载安装 Docker Desktop 并启动它 - 注意：Docker Desktop 在 macOS 和 Windows 11 WSL2 下行为略有差异，但只要状态栏有鲸鱼图标且显示 “Docker Desktop is running”，VS Code 就能调用
