Remote-SSH插件无法调试远程端插件，因其架构严格分离：所有插件由本地VSCode主进程加载执行，vscode-server仅提供文件访问、终端等底层能力，不运行插件代码。
VSCode 的 Remote-SSH 插件本身不支持“在远程端调试插件”，你真正能调试的，是运行在本地 VSCode 实例上的插件逻辑；远程服务器只承载 vscode-server 的运行时环境，它不执行插件代码。
为什么不能直接调试远程端的插件？
Remote-SSH 的架构是明确分离的：所有插件（包括你写的扩展）都由本地 VSCode 主进程加载和执行；vscode-server 只负责文件系统访问、终端启动、语言服务器代理等底层能力。它没有 Node.js 沙箱，也不加载任何 .vsix 或 package.json 中声明的 extension host 逻辑。
常见误解场景：
- 你在远程服务器上改了插件源码，然后 reload window —— 不生效，因为插件根本没部署到远程
- 你试图在远程终端里运行
npm run watch并期望断点进 VSCode UI —— 不可能，那只是普通 Node 进程 - 你看到
~/.vscode-server/extensions/下有插件目录 —— 那些只是被本地同步过去的 UI 资源（如图标、语法高亮 JSON），不是可执行体
如何正确调试一个依赖 Remote-SSH 的插件？
关键在于：把插件开发环境留在本地，但让它的行为作用于远程上下文。比如你写了一个“自动在远程执行 git status”的命令，调试重点是命令触发逻辑、参数拼接、SSH 终端调用链，而不是远程机器上跑了个什么新进程。
实操要点：
- 本地 VSCode 必须安装并启用你的插件（
npm install+npm run compile+F5启动 Extension Development Host） - 调试前先通过 Remote-SSH 正常连接到目标服务器，确保
vscode-server已就绪（左下角显示SSH: xxx） - 在插件代码中使用
vscode.workspace.getConfiguration('remote.SSH')或vscode.env.remoteName === 'ssh-remote'判断当前是否处于 SSH 远程会话 - 涉及终端操作时，优先用
vscode.window.createTerminal({ name: 'my-remote-cmd', shellPath: '/bin/bash', env: { ... } })，而非硬编码ssh user@host - 若需读取远程文件内容，走
vscode.workspace.fs.readFile(uri)（URI 必须是vscode-remote://ssh-remote+xxx/...格式）
遇到 “找不到远程路径” 或 “权限被拒绝” 怎么办？
这类报错几乎都源于 URI 构造或权限上下文错误，不是插件本身 bug：
-
vscode.Uri.file('/home/user/project')是错的 —— 它生成的是本地文件 URI，在远程会话里无法解析；必须用vscode.Uri.parse('vscode-remote://ssh-remote+myserver/home/user/project') - 调用
vscode.workspace.fs.readFile()前，确保该 URI 对应的文件真实存在于远程服务器，且当前登录用户有读权限（ls -l确认） - 执行 shell 命令失败时，检查
env是否继承了远程 shell 的 profile（比如~/.bashrc里没设PYTHONPATH，导致python -m mymodule找不到模块） - 调试器附加失败？确认你没在插件里调用
vscode.debug.startDebugging()去 attach 远程进程 —— VSCode 不支持跨 SSH 的 debug adapter 自动发现
最易被忽略的一点：插件的 activationEvents 里如果写了 "onCommand:xxx"，它只在本地命令注册表生效；而远程会话中触发该命令，仍由本地插件实例响应 —— 所以你看到的“远程效果”，其实是本地逻辑通过 Remote-SSH 提供的 API 驱动远程环境的结果。别试图绕过这个模型去“黑进” vscode-server 进程。
