手动安装的VS Code扩展在远程环境中不显示的问题排查与解决

1. 操作失误分析 #

你确实存在操作偏差：本地VS Code的$HOME/.vscode/extensions仅作用于本地环境，而远程开发时，VS Code的服务端运行在远程机器上，它只会扫描远程机器的扩展目录，完全不会读取本地的$HOME/.vscode/extensions内容。你之前仅在本地部署了扩展文件，远程机器上并没有对应的扩展文件，这就是导致远程环境无法识别调试类型的核心原因。

2. 远程环境启用扩展的步骤 #

步骤1：定位远程机器的VS Code扩展目录 #

远程机器的VS Code扩展存储在用户目录下的~/.vscode-server/extensions路径中（这是VS Code Remote服务端的默认扩展目录）。

步骤2：在远程机器部署扩展文件 #

• 在远程机器的~/.vscode-server/extensions下创建一个与扩展版本匹配的子目录，比如llvm.lldb-vscode-17.0.6（版本号需与package.json中的version字段一致）。
• 将lldb-server、lldb-vscode二进制文件和package.json复制到这个新建的子目录中。
• 给二进制文件添加可执行权限：

  chmod +x ~/.vscode-server/extensions/llvm.lldb-vscode-17.0.6/lldb-server
  chmod +x ~/.vscode-server/extensions/llvm.lldb-vscode-17.0.6/lldb-vscode
  

步骤3：重启远程VS Code连接 #

关闭当前的远程项目窗口，重新通过VS Code远程连接到目标机器。此时VS Code会扫描远程的扩展目录，自动识别并加载lldb-vscode扩展。

步骤4：验证调试配置 #

检查项目根目录下.vscode/launch.json中的调试配置，确保：

• type字段为lldb-vscode
• program字段指向远程机器上的可执行文件路径（而非本地路径）

额外检查点 #

• 确保远程机器上的LLDB版本与本地使用的版本兼容，避免版本差异引发的兼容性问题。
• 若远程连接使用SSH，确认远程机器上的VS Code Server版本与本地VS Code客户端版本匹配，版本差异可能导致扩展加载失败。

内容的提问来源于stack exchange，提问作者Henrique Bucher