VSCode中MSSQL扩展添加连接报错：找不到mssql.addObjectExplorer命令

环境信息 #

• MSSQL扩展版本：v1.19.1
• VSCode版本：1.70.2（Universal）
• 操作系统：macOS 14.4.1（23E224）

解决步骤 #

1. 确认扩展安装路径（纠正Windows路径误区） #

macOS下VSCode扩展默认路径为~/.vscode/extensions，而非Windows的%USERPROFILE%.vscode\extensions。前往该路径查看ms-mssql.mssql-1.19.1文件夹结构：

• 若缺少sqltoolsservice相关目录/文件，说明扩展安装不完整，需重新清理安装。

2. 完全清理并重装扩展 #

• 关闭所有VSCode窗口
• 删除~/.vscode/extensions/ms-mssql.mssql-1.19.1整个文件夹
• 删除VSCode缓存目录：

  rm -rf ~/Library/Caches/Code/Cache
  rm -rf ~/Library/Caches/Code/CachedData
  

• 重启VSCode，重新搜索安装MSSQL扩展v1.19.1

3. 查看扩展宿主日志定位问题 #

打开命令面板，输入Developer: Show Extensions Host Log，查找以下关键信息：

• 扩展加载失败的报错（如依赖缺失、权限不足）
• sqltoolsservice启动失败的具体原因

4. 尝试切换扩展版本 #

• 若当前v1.19.1存在兼容性问题，可降级至v1.19.0或升级至兼容VSCode 1.70.2的最新版本：
  1. 打开MSSQL扩展详情页，点击版本号下拉菜单
  2. 选择其他版本安装，重启VSCode后测试

5. 检查系统权限 #

• 若VSCode来自App Store，可能受沙箱限制，建议替换为官网下载的VSCode版本
• 前往「系统设置-隐私与安全性-文件与文件夹」，确保VSCode拥有访问~/.vscode目录的权限

可提供的补充信息 #

• 扩展宿主日志中的错误片段
• ~/.vscode/extensions/ms-mssql.mssql-1.19.1目录的文件列表
• 扩展安装时的输出日志（命令面板输入Extensions: Show Installed Extensions，找到MSSQL扩展后点击「Show Output」）

内容的提问来源于stack exchange，提问作者Max Scialabba