调试无头服务器上vscode插件必须通过本地vscode+remote-ssh连接后，在远程窗口中f5启动；直接在服务器执行code --extensiondevelopmentpath=.会失败，因extension development host依赖gui环境，且必须用attach模式（type: "extensionhost", request: "attach"）并手动触发命令才能激活插件逻辑。
调试运行在无头服务器上的 VSCode 插件后台，本质是调试一个在远程 Linux 服务器上、无图形界面环境下运行的 Extension Development Host 实例——不能靠本地弹窗或浏览器附加，必须走远程 attach 模式，且插件激活逻辑必须被显式触发。
为什么直接 F5 在服务器上没反应？
VSCode 插件调试依赖 Extension Development Host 环境来加载 package.json 中的 activationEvents 和 contributes。在无头服务器上直接运行 code --extensionDevelopmentPath=. 会失败，因为该命令需要 GUI 支持（即使加 --no-sandbox --disable-gpu 也无效）。你看到的“没输出、断点不命中”，根本不是代码问题，而是环境根本没起来。
- 不要在服务器终端执行
code --extensionDevelopmentPath=.—— 它会卡住或报Failed to create window - 真正可行的路径只有一条：用本地 VSCode +
Remote - SSH连到服务器，再在远程窗口里按F5 - 确保服务器已安装完整桌面依赖（如
xvfb）毫无意义；VSCode Server 不需要 X11，但开发主机模式必须由本地 VSCode 启动
launch.json 必须配成 attach 模式并指定 remoteRoot
在通过 Remote - SSH 连入服务器后的项目里，.vscode/launch.json 不能用 request: "launch"，否则调试器会尝试在服务器上启动新进程，而该进程无法承载插件上下文。必须用 attach 并精准对齐路径映射。
-
"type": "extensionHost"是强制要求，不是可选；用"node"类型会导致vscode全局对象为undefined -
"request": "attach"，配合"port": 9229（默认）——VSCode Server 会在 extension host 启动时自动开启调试端口 -
"remoteRoot": "${workspaceFolder}"和"localRoot": "${workspaceFolder}"必须一致，否则 sourceMap 找不到 TS 源文件 - 如果项目用了 TypeScript，确认
outFiles包含"${workspaceFolder}/out/**/*.js"，且tsconfig.json中"sourceMap": true已启用
断点只在 activate 或命令回调里有效，且必须手动触发
后台逻辑不会“自动运行”。VSCode 插件的 activate 函数只在满足 activationEvents 时调用，比如 "onCommand:myext.doSomething"。你在 activate 里打的断点，若没触发对应事件，就永远不执行。
- 最简验证方式：按
Ctrl+Shift+P→ 输入你的命令 ID（如My Extension: Say Hello）→ 回车。这时activate和命令回调里的断点才会被命中 - 别在
deactivate打断点指望它自动触发——它只在插件卸载时调用，而远程调试中插件不会自动卸载 - 如果命令没出现在命令面板，检查
package.json的contributes.commands是否拼写正确，ID 是否和registerCommand调用完全一致 - 日志输出请用
vscode.window.showInformationMessage()或console.log()，后者需打开Developer: Toggle Developer Tools查看 Remote Server 控制台
离线服务器要提前部署好 VSCode Server 二进制
首次通过 Remote - SSH 连接时，VSCode 会自动从官网下载 vscode-server.tar.gz 并解压到 ~/.vscode-server/bin/。如果服务器完全离线，这个过程会卡死，且留一个空的 vscode-server.tar.gz 文件在目录里，后续连接全失败。
- 解决办法：在有网机器上访问
https://update.code.visualstudio.com/commit:<commit_id>/server-linux-x64/stable</commit_id>（COMMIT_ID可从本地 VSCode 关于页复制），下载 tar.gz，手动传到服务器对应~/.vscode-server/bin/<commit_id>/</commit_id>目录并解压 - 务必核对 commit ID 完全一致，否则版本不匹配会导致调试器拒绝连接
- 离线环境还建议提前在服务器装好
node（≥16）、npm和git，避免调试时因依赖缺失中断流程
